Apple Pay (on web)

When processing Apple Pay on your website you can use our certificates or you can use your own. Using our certificates avoids the need to obtain an Apple Developer account and the complex process of certificate management. However, it is important to note that you are still required to provide merchant validation.

In this guide we have set out two processes, decide which process you would like to use:

• Set up Apple Pay (our certificates)
• Set up Apple Pay (own certificates)

Set up Apple Pay (our certificates)

Step 1: Register web domains

In order to accept Apple Pay via Acquired.com, you need to register your domains within the Hub.

1. Login to the Hub.
2. Navigate to Settings > Payment Methods > Apple Pay.
3. Under Web Domains, hit + Add Domain.
4. Enter the domain that you wish Apple to provide access for.
5. Click to Download Verification File.
6. Host the file at - https://[DOMAIN_NAME].well-known/apple-developer-merchantid-domain-association
7. Click Register Domains.

Step 2: Setting the merchantIdentifier

We will then register your domains with Apple and set an internal merchantIdentifier for your account.

📘

Note

When setting the merchantIdentifier for canMakePaymentsWithActiveCard or any other request where it is required please use your assigned company_id value.

Step 3: Providing merchant validation

We will perform a request for an Apple Pay payment session on your onvalidatemerchant event handler, as you do not have a merchant or payment processing certificate.

1. Request the merchantSession from us via the API.
2. When you receive the response, Base64 decode the merchant_session value and then pass this value in your completeMerchantValidation method.

View our Generate a Merchant Session API reference documentation here.

Request:

{
  "domain": "store.mydomain.com",
  "display_name": "myStore",
  "validation_url": "https://apple-pay-gateway.apple.com/paymentservices/startSession"
}

Response:

{
  "merchant_session": "{{Base64}}"
}

Step 4: Set the supportedNetworks property

Acquired.com supports Apple Pay payments from Visa, Mastercard and Amex cards. You can define these cards in the supported_networks property when integrating. View the Apple Developer documentation here.

📘

Note

If you want to enable Amex cards there is further configuration needed for a specific Amex MID. Raise a request via our support portal for further information.

Step 5: Set the merchantCapabilities property

Define the 3DS merchant_capabilities option. View the Apple Developer documentation here.

Step 6: Process an Apple Pay payment

Now that you have configured Apple Pay you can process a payment using our guide here.

Set up Apple Pay (own certificates)

Step 1: Apple Developer account

First, you need to set up your Apple Developer account. Follow this link and go to Account in the top right-hand corner. (If you already have an Apple Developer account, go to step 2.)

📘

Note

An Apple Developer account has an annual cost of around £80.

Step 2: Create a merchantIdentifier

A merchant identifier uniquely identifies you as a merchant who is able to accept Apple Pay payments.

1. Log into your Apple Developer account.
2. Follow the Apple Developer Account Help instructions to create a merchantIdentifier.

Step 3: Create a payment processing certificate

A payment processing certificate is associated with your merchantIdentifier and used to encrypt payment information. The payment processing certificate expires every 25 months.

1. Log into the Hub.
2. Go to Settings > Payment Methods > Apple Pay.
3. In the iOS Certificates section select + Add Certificates and enter the merchantIdentifier that you have just set up.
4. Click to Download CSR File (this file is generated by Acquired.com).
5. Go back to the Apple Developer portal and click into the merchantIdentifier that you just created.
6. Follow the Apple Developer Account Help instructions to create a Payment Processing Certificate.
7. When it asks you to Upload a Certificate Signing Request, drag and drop the CSR file that Acquired.com created for you in step 2.
8. Hit download in the Apple Developer portal and a .cer file will be created.
9. Go back to the Hub.
10. Click Upload Certificate, open the .cer file and hit Continue.

📘

Note

All the steps in this process are outlined in the pop-up '+ Add Certificates' window in the Hub.

Step 4: Register and validate your merchant domain

This process is exclusively between the merchant and Apple, Acquired.com are not involved.

1. Go to your Apple Developer account.
2. Follow the Apple Developer Account Help instructions to register a merchant domain.

Step 5: Create a merchant identity certificate

For each transaction that you make, you need to request an Apple Pay Payment Session using your merchant identity certificate.

It is important to note that this process exists exclusively between you and Apple. Acquired.com are not involved.

View the Apple Developer Account Help instructions to understand how to create and manage your merchant identity certificate.

Step 6: Set the supportedNetworks property

Acquired.com supports Apple Pay payments from Visa, Mastercard and Amex cards. You can define these cards in the supported_networks property when integrating. View the Apple Developer documentation here.

📘

Note

If you want to enable Amex cards there is further configuration needed for a specific Amex MID. Contact our support team for more information.

Step 7: Set the merchantCapabilities property

Define the 3DS merchant_capabilities option. View the Apple Developer documentation here.

Step 8: Process an Apple Pay payment

Now that you have configured Apple Pay you can process a payment using our guide here.