Contents

Register Merchant

Register a merchant and its corresponding set of fully qualified domains.

URL

POST https://apple-pay-gateway.apple.com/paymentservices/registerMerchant

Response Codes

StatusReasonTypeDescription
200OK

Success.

400Bad Request

The request is malformed or invalid.

401Unauthorized

The e-commerce platform doesn’t have permission to call this API.

417Expectation Failed

The e-commerce platform isn’t registered with Apple Developer.

500Internal Server Error

An internal server error occurred.

Mentioned in

Discussion

Call this API to register a merchant and their domains. You can register domains in multiple requests. The API has a limit of 99 domain names per partnerInternalMerchantIdentifier.

Before making a Register Merchant request, you must prepare each domain included in the request for verification. For more information on domain verification, see Preparing merchant domains for verification.

This request returns no response body for a successful 200 response. Apple Pay servers register the relationship between the e-commerce partner, the merchant, and the merchant’s domains.

HTTP Body

The request body you use to register merchants.

See Also

Web Merchant Registration