Apple Pay on the Web

Eliminate payment friction. Let your customers pay with Apple Pay on the Web.

Apple Pay on the Web

Recurly has added support for Apple Pay as a payment method on your web pages. If you are considering accepting payments via Apple Pay on the Web, we encourage you to read Apple's getting started guide.

Please note: Apple Pay on the Web is supported in Recurly.js v4. Apple Pay on the Web currently does not support Recurly hosted pages.

Payment gateways

  • Supported : Stripe, Braintree, Vantiv, Cybersource, Adyen, Chase Orbital
  • Not supported :, First Data, PayPal (all gateways), Worldpay

If you’d like to see support for other gateways, please contact Recurly Support so we can track your request.

Below are the steps for integrating with Recurly's solution.



  • Create an Apple Merchant ID and sign up for an Apple Developer’s Account. You can do this by visiting Apple’s developer site here. You can also reference Apple’s documentation for more information here.
  • Verify the domain where your checkout page with Apple Pay will reside. Apple’s documentation describes this process here.


  • Upgrade to Recurly.js V4 if you’re not on this version already. More information on Recurly.js can be found here.
  • Add a supported gateway to your Recurly site.

Getting Started

Once you’ve completed the prerequisites described above, contact Recurly Support to have the following actions completed:

  • Enable the Apple Pay feature flags for your site and gateway.
  • Generate Certificate Signing Request files (CSRs), which will be used to generate the appropriate Apple Pay Payment and Merchant Identity Certificates. You must use Recurly-provided CSRs for this integration to work correctly. Since each CSR is unique to a merchant account, please give several business days to have the appropriate CSRs generated.

Configuration in Apple and Recurly

After Recurly Support has provided the appropriate CSRs, you’re able to move forward with the next steps. First, generate the appropriate certificates using the provided CSRs via the steps below:

  1. From the Apple Developer’s Portal, select “Apple Pay Certificate”.

  1. Select the appropriate Merchant ID on the next page.
  2. Upload the attached CSR labeled “payment.csr”.
  3. Repeat the steps above, but select “Merchant Identity Certificate” and use the “merchant_id.csr” file the second time around.

For reference, the Merchant Identity Certificate is required to authenticate your merchant sessions with Apple Pay servers. The Apple Pay Certificate (also called Payment Processing Certificate) is required to submit and process transactions with Apple Pay on your behalf.

Once the appropriate certificates have been generated, you’ll want to upload them to your Recurly site and fill out the rest of the configuration fields. Please be sure to do this via the steps outlined below:

  1. From the Recurly console, go to Configuration > Apple Pay.

  1. Enter the domain of your store that has been verified with Apple. This should be in the format
  2. Enter the store name that you’d like the customer to see when making a purchase.
  3. Enter the URL where your customers can change their billing information. This should be in the format
  • If you are using Hosted Pages Account Login, Recurly can determine the management URL for you.
  1. Finally, upload the certificates to the appropriate boxes as described below:
  • Merchant Identity Certificate to Merchant ID Certificate section.
  • Apple Pay Certificate to the Payment Processing Certificate section.
  1. Ignore the sections labeled “Payment Processing Private Key” and “Merchant ID Private Key”. These will be entered by Recurly.
  2. For reference, please see the screenshot below for steps 2 through 5 above:

Braintree Setup

The steps to enable Recurly's Apple Pay integration on Braintree are different from the other gateways. There is work that must be done with both Recurly and Braintree.

1. Enable Apple Pay on Braintree

Follow the instructions listed here within Braintree's Apple Pay documentation

2. Enable Apple Pay on Recurly

  1. Reach out to Recurly to enable the Feature Flag for Enable Apple Pay Web Payments
  2. Check option Enable Apple Pay on the Gateway Configuration page for Braintree within Recurly
  3. Update Recurly.js V4 checkout page to include the Apple Pay with Braintree client authorization as defined in Recurly's developer documentation

Note: There is no need to any configuration in Recurly under Configuration->Apple Pay when using Apple Pay within Braintree

Integration Notes

To view the Recurly.JS documentation, visit the Developers documentation at:


Recurly Support will assist you with detailed instructions on how to get configured with Recurly to process Apple Pay on the Web transactions.