Skip to content
Manual

Form Integration

Merchant Payment Domain Registration Process

The merchant payment domain registration process depends on the domain registrar where the payment address is hosted. We recommend using third-level domains — for example, if your main website is mysite.com, you can register a domain like applepay.mysite.com for Apple Pay. We don’t have strict technical requirements regarding the domain level or its name format (including the use of abbreviations or shortened forms). Such limitations are usually dictated by business goals or the registrar’s own policies.

Merchant Payment Domain Verification Process

After registering the domain applepay.mysite.com, you need to verify it in your Apple Pay merchant account. A detailed description of the process is available in Apple’s official documentation, which may be updated periodically. You can find the current version at: https://developer.apple.com/documentation/applepaywebmerchantregistrationapi/preparing-merchant-domains-for-verification. Verification is only possible when you have access to both your Apple Pay merchant account and your domain registrar’s control panel, as completing all the steps specified in the documentation requires changes on the domain side.

Process of Redirecting DNS of the Payment Domain to the Processing IP

After registering the domain, you need to direct its DNS records to the processing IP addresses. This can be done in one of the following ways:

  • specify an A record in the DNS settings;
  • add TXT or CNAME records if the domain is hosted on Cloudflare. To get the current list of A records or the necessary TXT/CNAME records, contact your manager. They will provide you with either the processing IP addresses or the exact record parameters that need to be added in your Cloudflare account.

Process of Issuing SSL Certificates for Payment Form Domains

For proper operation of the payment site, you need to provide SSL certificates. There are two options for obtaining them:

Order certificate issuance through your manager.

In this case, you provide the domain name, after which you’ll need to confirm domain ownership by creating a set of CNAME records in your registrar’s DNS control panel. The manager will provide a list of required records.

Issue SSL certificates independently.

You can use any certificate issuance service, for example: https://cheapsslweb.com. After issuance, you need to provide your manager with: private key (usually in .p12 format) and its password; certificate chain, which can be downloaded from the SSL registrar’s website.

Merchant Setup Process in Apple Pay

All parameters specified during Merchant ID registration in Apple Pay become available in the browser via JavaScript and, consequently, are visible to the end user. Therefore, it’s important to use only verified and correct data.

The registration process may change, so we recommend always using the current version of Apple’s documentation:

  1. Creating a Merchant ID

    Follow the link and instructions to create a merchant identifier: https://developer.apple.com/documentation/applepaywebmerchantregistrationapi/registering-with-apple-pay-and-applying-to-use-the-api#Create-Your-Apple-Pay-Merchant-ID

  2. Domain Verification and Certificate Issuance After creating the Merchant ID, you need to:

  3. Uploading the Payment Processing Certificate

    After completing all settings, you need to download the Payment Processing Certificate from your Apple Pay account.

Account Setup

To complete the configuration in the console, you need to prepare and specify the following data:

  1. Merchant ID,
  2. Private key of the Merchant Identity Certificate,
  3. Private key of the Payment Processing Certificate.

These parameters must be entered in the bank terminal settings in the Apple Pay section.

Additionally:

  • SSL certificates for the merchant’s payment domain must be provided to your manager for infrastructure deployment on the processing side.

After completing all settings, you need to generate a Bearer Token to work with the specified domain.

If the required domain (HOST) is not in the list, contact your manager to add it.

  • When configuring independently, set the Default card type on Requestor to Apple Pay.