Skip to main content
A Payment Method Domain registers a hostname with a wallet provider so its payment methods can appear at a checkout served from that domain. The domain proves ownership by hosting the provider’s association file — for Apple Pay, at /.well-known/apple-developer-merchantid-domain-association — and status reports whether verification has completed. Use the Payment Method Domains API to register domains for your account or its connected accounts, retry verification once the association file is hosted, and remove domains that should no longer serve wallet payments. A domain a platform shares with its connected accounts at checkout is listed on the platform’s account, not on each connected account.

​
Endpoints

​
Attributes

​
string
required
Payment method domain ID, prefixed pmd_.
​
string | null
required
ID of the account the domain is registered for, prefixed biz_.
​
string
required
When the domain was created, as an ISO 8601 timestamp.
​
string
required
Hostname the checkout is served from (e.g. checkout.example.com).
​
string
required
Wallet provider the domain is registered with.Available options: apple
​
string
required
Verification status. pending means the provider could not fetch the domain-association file yet; only verified domains show wallet payment methods at checkout.Available options: pending, verified
​
string
required
When the domain was last updated, as an ISO 8601 timestamp.
PaymentMethodDomain