As mentioned in the How to configure Zuora Rate Plan in Limio user guide, Limio's no-code subscription commerce platform is fully integrated with Zuora out of the box! This user guide shows how to set up the Zuora Payment Type in Limio.
Limio allows integration of Apple Pay for Zuora, a digital wallet and a mobile payment method enabling customers 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 decreases when a wallet is offered as a payment option.
Before you start
Zuora provides direct integration to add Apple Pay as a payment method that can be used in Limio Checkout, this requires an Apple Developer Account and configuration set-up in Limio and Zuora.
Ensure Apple Pay is set up by following the Apple documentation - Setting up Apple Pay:
- 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.
Overview of actions:
- Add the Limio Shop to Merchant Domains in the Apple Developer Dashboard
- Request Zuora to create a Certificate Signing Request
- Share the Apple Pay Merchant Identity Certificate with Limio
- Add Apple Pay as a payment gateway
- Add the Apple Pay as an allowed host
- Add the Apple Pay script to Limio Pages
- Add the Apple Pay payment type
Add the Limio Shop to Merchant Domains in the Apple Developer Dashboard
- Set up a Merchant Identifier follow these steps in the Apple Developer documentation.
- Once created:
- Add the Limio Shop domain in the "Merchant Domains" section of the Merchant Identifier in the Apple Developer dashboard.
- Then download the apple-developer-merchantid-domain-association.txt file that is generated.
- Email it to support@limio.com so we can assist in uploading the file.
- Once that is done "verify" the domain in Apple.
📷 Screenshot: Merchant Identifier - download
Request Zuora to create a Certificate Signing Request
- Contact Zuora Global Support to generate a Certificate Signing Request (CSR) file (.certSigningRequest extension)
- Zuora Global Support will then send the CSR file.
- Upload to the Apple Developer dashboard to generate the Apple Pay Payment Processing Certificate.
- To integrate with Limio, both the Apple Pay Merchant Identity Certificate and its matching key are required.
- To generate the certificate, go to the Merchant ID Dashboard click "Create Certificate", then follow the prompts.
📷 Screenshot: Apple Pay Merchant Identity Certificate - create
Share the Apple Pay Merchant Identity Certificate with Limio
Note: Ensure that the person who downloads the Apple Pay Merchant Identity Certificate from the Apple dashboard is the same person who created it. This is necessary to access the key linked to the certificate.
It is best practice to export both the certificate and key as a password-protected .p12 file - How to Create a .p12 File
Please send the .p12 file and its password to support@limio.com
Add Apple Pay as a payment gateway
- 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 the Apple Developer console, 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.
- Provide a Display Name, this is the name that will be seen on the iOS or macOS device when approving the payment.
- It must be representative of your Business.
- Configure Apple Zuora gateway details: Settings -> General Settings -> Apple
- Similar to Zuora Payment Gateway configuration Apple Pay requires its own Payment Gateway configuration in Limio.
- Apple Pay payments can be routed through different providers than Credit Card, PayPal etc.
- Fields to configure:
- 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=xxxxxxxx
- 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
📷 Image: Apple Pay Display Name - create (e.g 'Limio')
Add the Apple Pay as an allowed host
To ensure that Apple Pay is not blocked by the Content Security Policy (CSP), add Apple Pay as an allowed host. Follow the guide - add hosts to your Content Security Header. Add the host: https://*.apple.com
Add the Apple Pay script to Limio pages
To display Apple Pay Checkout, add the script to the page. This can be page level, add the below to the "Inject Code" page attribute and save, rebuild and republish the page.
<script src="https://applepay.cdn-apple.com/jsapi/v1/apple-pay-sdk.js"></script>
Add the Apple Pay Payment Type
The Payment Type field includes how a customer can pay for the subscription. To learn how to configure the Limio Offer to accept Apple Pay Zuora as a Payment Type follow this guide - how to configure Zuora Payment Type on the Offer.
Note: Apple Pay will only be available on the Limio Checkout when browsing from an iOS or a macOS device, even if enabled on the Limio Offer.
Once this setup is complete Apple Pay is available as a single-click option to complete a purchase on the Limio Checkout!
📷 Screenshot: Buy with the Apple Pay button
Comments
0 comments
Please sign in to leave a comment.