Create Payment Method Domain
Registers a hostname with the wallet provider and attempts verification inline. Returns verified when the provider fetched the domain-association file (for Apple Pay, /.well-known/apple-developer-merchantid-domain-association), or pending when it could not — host the file, then retry with the verify endpoint.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-08-05-1"
Body
Response
domain registered as pending when verification fails
ID of the account the domain is registered for, prefixed biz_.
When the domain was created, as an ISO 8601 timestamp.
Hostname the checkout is served from (e.g. checkout.example.com).
Payment method domain ID, prefixed pmd_.
Wallet provider the domain is registered with.
apple "apple"
Verification status. pending means the provider could not fetch the domain-association file yet; only verified domains show wallet payment methods at checkout.
pending, verified "pending"
When the domain was last updated, as an ISO 8601 timestamp.

