The Reference Docs Developer Hub

Welcome to the Reference Docs developer hub. You'll find comprehensive guides and documentation to help you start working with Reference Docs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

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 : Vantiv, Stripe
  • Not supported : Authorize.net, Braintree, Chase Orbital, Cybersource, Adyen, First Data, PayPal (all gateways), Sagepay, Wirecard, Worldpay

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

Prerequisites

Apple-side

  • 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.

Recurly-side

  • 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. Currently, Recurly supports Apple Pay on the Web for merchants using Vantiv and Stripe. If you’d like to see support for other gateways, please contact Recurly Support so we can track your request.

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 www.DOMAIN.com.
  2. Enter the store name that you’d like the customer to see when making a purchase.
  3. 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.
  4. Ignore the sections labeled “Payment Processing Private Key” and “Merchant ID Private Key”. These will be entered by Recurly.
  5. For reference, please see the screenshot below for steps 2 through 4 above:

Integration Notes

To view the Recurly.JS documentation, visit the Developers documentation at: https://dev.recurly.com/docs/recurly-js-apple-pay

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