Sign in
latestOpenAPI 3.1.02026-08-153864115.7 MB

c301132dbfd7

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

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "created_at": "2026-01-01T12:00:00.000Z",
  "hostname": "checkout.shinetime.example",
  "id": "pmd_xxxxxxxxxxxxxx",
  "provider": "apple",
  "status": "verified",
  "updated_at": "2026-01-01T12:00:00.000Z"
}