# Configure Apple Pay

As mentioned in the 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 - :

* 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

1. Set up a Merchant Identifier documentation.
2. 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 so we can assist in uploading the file.
   * Once that is done "verify" the domain in Apple.

📷 *Screenshot: Merchant Identifier - download*\
![Screenshot 2024-05-24 at 15.01.37.png](https://limio.zendesk.com/hc/article_attachments/19090731281053)

***

### Request Zuora to create a Certificate Signing Request

1. Contact 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.
2. To integrate with Limio, both the and its matching key are required.
3. To generate the certificate, go to the Merchant ID Dashboard click "Create Certificate", then follow the prompts.

📷 *Screenshot: Apple Pay Merchant Identity Certificate - create*\
![Screenshot 2024-06-05 at 12.17.39.png](https://limio.zendesk.com/hc/article_attachments/19335476180637)

### **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 -

Please send the **.p12 file** and its password to

***

### Add Apple Pay as a payment gateway

1. 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.**
2. 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.
3. 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.
4. Configure Apple Zuora gateway details: **Settings -> General Settings -> Apple**
   * Similar to 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')*

![IMG\_5845.jpeg](https://limio.zendesk.com/hc/article_attachments/4486486465949)

***

### 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 the host:

***

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

***

### 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 -

**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*

![mceclip2.png](https://limio.zendesk.com/hc/article_attachments/4469006531741)
