v14

latestOpenAPI 3.1.02026-08-083813925.4 MB

Payment Method Domains

Verify Payment Method Domain

Re-attempts provider verification of a pending domain once the association file is hosted. Fails with a bad_request explaining what to fix; verifying an already verified domain is a no-op.

post/payment_method_domains/{id}/verify

Headers

Idempotency-Keystring

Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Response

already verified domain is a no-op

account_idstring nullable required

ID of the account the domain is registered for, prefixed biz_.

created_atstring required

When the domain was created, as an ISO 8601 timestamp.

hostnamestring required

Hostname the checkout is served from (e.g. checkout.example.com).

idstring required

Payment method domain ID, prefixed pmd_.

provider'apple' required

Wallet provider the domain is registered with.

status'pending' | 'verified' required

Verification status. pending means the provider could not fetch the domain-association file yet; only verified domains show wallet payment methods at checkout.

updated_atstring required

When the domain was last updated, as an ISO 8601 timestamp.

Example response

{
  "provider": "apple",
  "status": "pending"
}