# Configure PayPal Commerce Platform

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

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](https://knowledgecenter.zuora.com/Zuora_Payments/Manage_payment_gateway_integrations_and_payment_methods/Set_up_payment_gateway_integrations/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.](https://knowledgecenter.zuora.com/Zuora_Payments/Process_payments/Payments_settings/Payment_Gateway_Authentication#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.](https://knowledgecenter.zuora.com/Zuora_Payments/Manage_payment_gateway_integrations_and_payment_methods/C_Managing_Payment_Gateways/C_Setting_Up_Payment_Gateways#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.](https://knowledgecenter.zuora.com/Zuora_Payments/Manage_payment_gateway_integrations_and_payment_methods/Set_up_payment_gateway_integrations/PayPal_Commerce_Platform_gateway/B_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**
   * **Integration ID** (Unique ID/name, that is used later 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?](https://www.paypal.com/us/cshelp/article/how-do-i-create-paypal-rest-api-credentials-ts1949)
   * 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](https://developer.paypal.com/api/rest/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 [Configure Payment Type on Offer](/integrations/zuora-integration/configuring-payment-gateways/configuring-payment-type/how-to-configure-zuora-payment-type-on-the-offer.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.limio.com/integrations/zuora-integration/configuring-payment-gateways/configuring-payment-type/configure-the-new-paypal-commerce-platform-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.