Create a Payment Method Domain

​

Registers a storefront domain or retries its verification. Host the Apple Pay verification file at /.well-known/apple-developer-merchantid-domain-association on that domain and confirm it is publicly accessible over HTTPS before sending this request.

For the dynamic-file workflow, first retrieve GET /v1/apple-pay/domain-association from your backend with the same account and test/live mode and the exact domain_name. Publish the returned content unchanged. Existing integrations can continue using the static download during the gradual rollout.

Registration starts verification; acceptance of this request does not guarantee that Apple Pay is ready to display. A 409 error with apple_pay_domain_association_conflict requires completing or reconciling incompatible outstanding verification before retrying.

See Apple Pay setup for the complete workflow.

Body·

required
application/json

Request parameters for creating a new payment method domain.

  • domain_name
    Type: string
    max length:  
    100
    required

    The domain name that this payment method domain object represents.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/v1/payment_method_domains
curl https://api.paypercut.io/v1/payment_method_domains \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "domain_name": ""
}'

{
  "id": "string",
  "created": "2026-11-05T09:18:50.957Z",
  "domain_name": "string",
  "enabled": true,
  "livemode": true
}

Payment method domain created or verification accepted.

Previous
List all Payment Method Domain
Next
Payments