Configure the new PayPal Commerce Platform integration

Limio now supports a new PayPal integration via the PayPal Commerce Platform through Zuora. This integration uses PayPal’s Reference Transactions API, enabling flexible recurring and one-time payments without predefined plans.

What’s in this guide

• Prerequisites

• How to set up the PayPal Commerce Platform in Zuora

• How to configure the PayPal Commerce Platform in Limio Commerce

• How to configure PayPal on Limio offers

Prerequisites

Before configuring PayPal in Limio, ensure the following:

• You have onboarded with PayPal’s Commerce Platform via a PayPal Business Merchant Account.

• Your PayPal account has a Primary Email Address set.

• Reference Transactions are enabled on your account.

  • 📩 If not enabled, contact your PayPal account manager.

Set up the PayPal Commerce Platform gateway in Zuora

Follow the steps in Zuora's PayPal Commerce Platform gateway documentation to configure your payment gateway. This includes:

1. Creating a gateway authentication to capture your PayPal Merchant ID. Create and manage merchant IDs for PayPal Commerce Platform.
2. Enabling the PayPal Commerce Platform Gateway in your Zuora tenant. Enable payment gateway integrations for your tenant. 
3. Setting up a new gateway instance, which will generate the Gateway ID required in Limio. Set up and configure a PayPal Commerce Platform gateway instance.

Configure the PayPal gateway in Limio Commerce

Once your gateway is set up in Zuora, proceed with the configuration in Limio:

Step 1: Add Zuora gateway details

1. Navigate to Profile > Settings > General Settings > PayPal.

2. Under PayPal Zuora gateway details, click Add new.

3. Enter:

   • Gateway name (exact match with Zuora setup)

   • Gateway ID (from Zuora)

   • Country codes where PayPal should be available

Step 2: Set PayPal general configuration

1. Scroll to PayPal general setup.

2. Set PayPal integration to PayPal Commerce (not “Express Checkout via Braintree”).

Step 3: Add PayPal commerce configuration

1. Under PayPal commerce configuration, click Add new.

2. Enter:

   • Name (must match the integration name added below)

   • Integration ID (used in the Integration tab)

   • Select country availability

Step 4: Connect your PayPal credentials

1. Go to Profile > Settings > Integration.
2. Scroll to Add Integration, then select PayPal.
3. In the modal:

   • Set the Name to the same Integration ID from the previous step.

   • Set Integration type to rest.

   • Enter the Client ID and Secret from your PayPal Developer Dashboard. How do I create PayPal REST API credentials?

   • Enable Vaulting by setting Use vaulting? to true.

   • Set the Intent to tokenize.

   • Set the endpoint to the value found in the PayPal documentation API Requests.

🔐 This setup ensures Limio captures a Billing Agreement ID (BAID). This is later used by Zuora to complete the transaction.

Campaign Settings

To offer PayPal as a payment method on a Limio Offer:

1. Open your Offer in the Offers Editor.
2. Locate the Payment method field.
3. Select the Zuora PayPal option.

This will allow the Modular Checkout to display PayPal as a payment option when the offer is published.

📚 For more detail, see how to configure Zuora Payment Type on the Offer.