How to configure Apple Pay for Zuora in Limio

As mentioned in our How to configure Zuora Rate Plan in Limio user guide, Limio's no code subscription commerce platform is fully integrated with Zuora, right out-of-the-box, and in this user guide we will show you how to setup the Zuora Payment Type in Limio. 

Limio allows you to integrate Apple Pay for Zuora, a digital wallet and a mobile payment method that enables the users to save their credit/debit card details and checkout with a single click on iOS and macOS devices.

Digital wallets have recently become the most sought after payment method for online transactions, as conversions can triple and cart abandonment significantly decrease when a wallet is offered as a payment option.

[Source] [Source]

Getting set up with Zuora Apple Pay Checkout

Zuora provides a direct integration to add Apple Pay as a payment that can be used in Limio Checkout. This will require an Apple Developer Account and some set up in Limio and Zuora. Before getting started in Limio:

You will need to follow Apple's guide in setting up Apple Pay. Most importantly, you will need to set up a Merchant Identifier, Payment Processing Certificate & Apple Pay Merchant Identity Certificate.

• A Merchant Identifier is a unique identifier registered with Apple that confirms that your business and website is allowed to do business via Apple Pay. Here you can verify the domains you want to use Apple Pay on.
• Payment Processing Certificate is a certificate which will be used for Payment Processing, Apple will use the public key to encrypt payment data. Zuora will use the private key to decrypt the payment data when processing the payment.
• Apple Pay Merchant Identity Certificate is used to authenticate your sessions with the Apple Pay servers. This allows transactions to occur on your Limio domain.

Steps required for Apple Pay/Zuora/Limio integration 

1. To set up your Merchant Identifier follow these steps in the Apple Developer documentation.
2. Once your Merchant Identifier is created, you will need to add your Limio Shop domain in the "Merchant Domains" section of your Merchant Identifier in your Apple Developer dashboard. Then download the apple-developer-merchantid-domain-association.txt file that is generated and email it to [e-mail] so we can assist in uploading the file. Once that is done you can "verify" the domain in Apple.
   
   
3.  Contact Zuora Global Support to generate a Certificate Signing Request file (.certSigningRequest extension) for you. Zuora Global Support will then send the CSR file to you, which you can then upload to your Apple Developer dashboard to generate your Apple Pay Payment Processing Certificate.
4. To integrate with Limio, we require both the Apple Pay Merchant Identity Certificate and its matching key. To generate the certificate, go to your Merchant ID Dashboard click "Create Certificate", then follow the prompts.
   
   
   
   Please note: you will need to make sure the person who downloads the Apple Pay Merchant Identity Certificate from the Apple dashboard was the one who created the certificate. This will ensure you can access the key linked to the certificate. It is best to export certificate and key as a .p12 file which is password-protected. Please send the .p12 and its password to [e-mail].

Set up in Limio

Once set up in Zuora and Apple is complete, you can access the settings in Limio for Zuora Apple Pay payment gateways, go to Profile -> Settings -> Apple. 

From your Apple Developer console you will need to find your Merchant Identifier, this identifies the Limio Checkout to Apple Pay as being able to accept payments, once the relevant domain has been verified with Apple.

Additionally, you need to provide a Display Name, this is the name that will be seen on the iOS or macOS device when approving the payment, so it is important that it is representative of your Business.

Similar to Zuora Payment Gateway configuration Apple Pay requires its own Payment Gateway configuration as often you will want Apple Pay payments to be routed through different providers than Credit Card, PayPal etc.

The Payment Gateways are set up in the same settings section:

Where:

• Gateway Name can be found in Zuora, on the Payment Gateway information page. It is the "Name" field in the Basic Information.
• Gateway ID is the Zuora Payment Gateway unique ID. This can be found in Zuora, on the Payment Gateway page. It will be appended to the URL as gatewayId=xxxxxxxxx
• Currency Codes is the list of currencies from which payments are accepted on this Payment Gateway
• Country Codes is the list of countries from which payments are accepted on this Payment Gateway

Add the Apple Pay as an allowed host

To ensure that Apple Pay is not blocked by the Content Security Policy (CSP), you will need to add Apple Pay as an allowed host. Follow our guide on how to add hosts to your Content Security Header. You can add the host https://*.apple.com

Add the Apple Pay script to desired Limio pages

For any pages you wish to display Apple Pay Checkout on, you will need to add the script to the page. This can be done on the page level, simply add the following to the "Inject Code" page attribute and then save, rebuild and republish your page.

<script src="https://applepay.cdn-apple.com/jsapi/v1/apple-pay-sdk.js"></script>

 

Limio for Zuora Apple Pay Payment Type

In Limio, Payment Type field (screenshot below) includes the way a customer will be able to pay for the subscription. To learn how to configure your Limio Offer to accept Apple Pay Zuora as a Payment Type follow the steps outlined in how to configure Zuora Payment Type on the Offer.

Note that even if enabled on the Limio Offer, Apple Pay will only be available on the Limio Checkout when browsing from an iOS or a macOS device.

Once this setup is complete you will be able to see Apple Pay available as single click option to complete a purchase on the Limio Checkout:

To help you get started with setting up the Zuora integration, please contact us at [e-mail].