---
title: RegisterMerchantRequest
framework: applepaywebmerchantregistrationapi
role: symbol
role_heading: Object
path: applepaywebmerchantregistrationapi/registermerchantrequest
---

# RegisterMerchantRequest

The request body you use to register merchants.

## Declaration

```data
object RegisterMerchantRequest
```

## Properties

domainNames: A list of fully qualified domain names for which Apple Pay processes payments for this merchant. Items must be unique within the scope of each partnerInternalMerchantIdentifier. The API is limited to 99 domain names per partnerInternalMerchantIdentifier. encryptTo: The payment platform integrator ID or merchant ID associated with the payment processing certificate Apple Pay will use to encrypt payment data on behalf of the merchant you’re registering. Typically, use the payment platform integrator ID of the calling e-commerce platform. If a party other than the e-commerce platform decrypts the Apple Pay data, use their payment platform integrator ID or merchant ID. merchantUrl: An optional field in which you provide the merchant website’s top-level domain. Supply this value when registering merchants using a shared payment page hosted on the payment platform’s domain. This URL doesn’t have to be affiliated with the payment transaction nor is it verified. partnerInternalMerchantIdentifier: A unique identifier that you create for the merchant you’re registering. Each merchant your e-commerce platform serves must have a unique identifier. This is the same identifier that you pass as the merchantIdentifier field into canMakePaymentsWithActiveCard and when requesting and Apple Pay payment session. For more information, see Requesting an Apple Pay payment session. The partnerInternalMerchantIdentifier value must use allowed characters only: a-zA-Z0-9~-_+&@$!|,.; partnerMerchantName: A human-readable name for the merchant; the API does not parse this name programmatically.

## Discussion

Discussion The following example shows the structure of a JSON object with information on how to register merchant requests. {     "domainNames" : [         "subdomain-1.example.com",         "subdomain-2.example.com"     ],     "partnerMerchantName" : "Example Merchant",     "partnerInternalMerchantIdentifier": "ABC-123456",     "encryptTo" : "platformintegrator.com.example",     "merchantUrl": "https://example.com" }

## See Also

### Web Merchant Registration

- [Preparing merchant domains for verification](applepaywebmerchantregistrationapi/preparing-merchant-domains-for-verification.md)
- [Register Merchant](applepaywebmerchantregistrationapi/register-merchant.md)