> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upmind.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Add PayPal Billing Agreement as a Payment Method

> Configure PayPal Billing Agreement

**PayPal Billing Agreements** enable automatic recurring payments, making it the recommended PayPal integration for most Upmind users. This method supports smooth recurring billing, whether or not reference transactions are enabled in your PayPal account.

In this guide, we will set up PayPal Billing Agreement. You will require:

* PayPal Business account

* Upmind admin access

## Obtaining API credentials from PayPal

1. Log in to your PayPal Business account.

2. Go to `Account Settings` (top right)

<Frame caption="Account settings">
  <img src="https://mintcdn.com/upmind/1-uICsJi9zYpvJVH/images/fb/8b0f550008e9eec0.png?fit=max&auto=format&n=1-uICsJi9zYpvJVH&q=85&s=46f63d2b85a04e06b0a4238a340d5e34" alt="Account settings" width="290" height="321" data-path="images/fb/8b0f550008e9eec0.png" />
</Frame>

3. Click **API Access** > **Update**.

<Frame caption="API access > Update">
  <img src="https://mintcdn.com/upmind/6knUVC8F1nK4E5CY/images/fb/c54c899b2cd64dd4.png?fit=max&auto=format&n=6knUVC8F1nK4E5CY&q=85&s=765ba28d8069757b432d5c204cd28a26" alt="API access > Update" data-og-width="996" width="996" data-og-height="402" height="402" data-path="images/fb/c54c899b2cd64dd4.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/upmind/6knUVC8F1nK4E5CY/images/fb/c54c899b2cd64dd4.png?w=280&fit=max&auto=format&n=6knUVC8F1nK4E5CY&q=85&s=49c9f9391d84092637a844ac5c41c12b 280w, https://mintcdn.com/upmind/6knUVC8F1nK4E5CY/images/fb/c54c899b2cd64dd4.png?w=560&fit=max&auto=format&n=6knUVC8F1nK4E5CY&q=85&s=09c447919aaa707b578870ddb9de16e2 560w, https://mintcdn.com/upmind/6knUVC8F1nK4E5CY/images/fb/c54c899b2cd64dd4.png?w=840&fit=max&auto=format&n=6knUVC8F1nK4E5CY&q=85&s=08931cc1f6173fb2984bd5812d0606be 840w, https://mintcdn.com/upmind/6knUVC8F1nK4E5CY/images/fb/c54c899b2cd64dd4.png?w=1100&fit=max&auto=format&n=6knUVC8F1nK4E5CY&q=85&s=f566bf29eaec468fd6dd52e04dc9b408 1100w, https://mintcdn.com/upmind/6knUVC8F1nK4E5CY/images/fb/c54c899b2cd64dd4.png?w=1650&fit=max&auto=format&n=6knUVC8F1nK4E5CY&q=85&s=6813d5491183d9df8cbe6a41615bcf40 1650w, https://mintcdn.com/upmind/6knUVC8F1nK4E5CY/images/fb/c54c899b2cd64dd4.png?w=2500&fit=max&auto=format&n=6knUVC8F1nK4E5CY&q=85&s=cbb656ec54e80f5521f9e623ebb60171 2500w" />
</Frame>

4. Under `Custom checkout experience`, locate `NVP/SOAP API Integration (Classic)` and click **Manage API credentials**.

5. Copy your **API Username**, **API Password**, and **Signature**.

<Frame caption="Copy credentials">
  <img src="https://mintcdn.com/upmind/Lh8hC132BWHpvRbz/images/fb/476f08f9af46314c.png?fit=max&auto=format&n=Lh8hC132BWHpvRbz&q=85&s=afc0dc782b82e487c58f5055f529b51b" alt="Copy credentials" width="2505" height="1421" data-path="images/fb/476f08f9af46314c.png" />
</Frame>

## Adding PayPal Billing Agreement in Upmind

1. In Upmind, go to **Settings** > **Payment Providers**.

2. Click **Add Payment Provider**.

3. Select **PayPal Billing Agreement** from the list.

<Frame caption="Select PayPal Billing Agreement">
  <img src="https://mintcdn.com/upmind/Lh8hC132BWHpvRbz/images/fb/47bb72eba387cb95.png?fit=max&auto=format&n=Lh8hC132BWHpvRbz&q=85&s=e37eadd373fd34725347dbaf34b5c39a" alt="Select PayPal Billing Agreement" width="780" height="256" data-path="images/fb/47bb72eba387cb95.png" />
</Frame>

4. Scroll down and enter a display name. We suggest **PayPal**.

5. Set **Test Mode** to **No** for live transactions.

6. Paste your **API Username**, **Password**, and **Signature** into the respective fields.

7. Click **Test Credentials** to verify the connection.

8. (Optional) Add supported currencies.

9. (Optional) Enter payment instructions for clients.

10. Click **Create** to activate the payment method.

<Frame caption="Fill in the details">
  <img src="https://mintcdn.com/upmind/JUoAg6onJmXk_-rR/images/fb/de8812e7e41f7c5c.png?fit=max&auto=format&n=JUoAg6onJmXk_-rR&q=85&s=858c7e167b6cb980232b5cd563938d02" alt="Fill in the details" width="774" height="500" data-path="images/fb/de8812e7e41f7c5c.png" />
</Frame>

## Editing PayPal Billing Agreement

To update or change settings, go to **Settings** > **Payment Providers**, click the three dots next to PayPal Billing Agreement, and select **Edit**.
