---
title: Register Merchant
framework: applepaywebmerchantregistrationapi
role: symbol
role_heading: Web Service Endpoint
path: applepaywebmerchantregistrationapi/register-merchant
---

# 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

200 OK: Success. 400 Bad Request: The request is malformed or invalid. 401 Unauthorized: The e-commerce platform doesn’t have permission to call this API. 417 Expectation Failed: The e-commerce platform isn’t registered with Apple Developer. 500 Internal Server Error: An internal server error occurred.

## Mentioned in

Preparing merchant domains for verification

## Discussion

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. note: To access the sandbox environment, use POST https://apple-pay-gateway-cert.apple.com/paymentservices/registerMerchant.

## HTTP Body

The request body you use to register merchants.

## See Also

### Web Merchant Registration

- [Preparing merchant domains for verification](applepaywebmerchantregistrationapi/preparing-merchant-domains-for-verification.md)
- [RegisterMerchantRequest](applepaywebmerchantregistrationapi/registermerchantrequest.md)