# PayPal Setup

To set up PayPal properly, please configure TEST and LIVE modes independently.&#x20;

[PayPal TEST Mode Configuration](https://docs.paymentpageplugin.com/payment-gateways/paypal/paypal-setup#paypal-test-mode-configuration)

[PayPal LIVE Mode Configuration](https://docs.paymentpageplugin.com/payment-gateways/paypal/paypal-setup#paypal-live-mode-configuration)

## Paypal TEST Mode Configuration

PayPal has a Developer Portal available at <https://developer.paypal.com.&#x20>;

There are three steps in the TEST Mode (Sandbox) setup required in order to fully test payments in TEST mode.&#x20;

1. Create a Sandbox Business Account - This will act as your "Business Account" to **receive** TEST payments and is necessary for creating the Sandbox Application (step #2).&#x20;
2. Create a Sandbox Application - This will provide the credentials to be entered into the Payment Page plugin settings to **receive** TEST payments.&#x20;
3. Create a Sandbox Personal Account - This will act as your "Personal Account" to **make** TEST payments. When making a test payment, you'll need to login with these credentials.&#x20;

### Create a Sandbox Business Account

To create a Sandbox Business Account, register for the Developer portal and then go to the [Sandbox > Accounts](https://developer.paypal.com/developer/accounts) section.&#x20;

Click "Create Account:"

![Creating a Sandbox PayPal Account](/files/6AnLraY9FAi5S62azTM4)

In the popup section, under Account Type, Select "Business (Merchant Account)" and your corresponding region:&#x20;

![Creating a Sandbox Business PayPal account](/files/vvTsgQS68ZHq326rDNeA)

Click "Create" and then you'll see the account appear in the list.

Under the Manage Accounts column, click the 3 dot menu, and select "View/Edit Account:"

Copy the email address into the Payment Page Plugin settings in TEST mode for PayPal:

![PayPal TEST Connection Settings in the Payment Page plugin settings](/files/cohIgfI1zNWqLPdLTKWS)

To obtain the Client ID and Secret for your application, proceed to create a Sandbox Application.&#x20;

### Creating a Sandbox Application

To create a Sandbox application,  go to the [PayPal My Apps & Credentials](https://developer.paypal.com/developer/applications) section.&#x20;

Under the REST API apps section, click "Create App:"&#x20;

![Creating a PayPal Sandbox Application](/files/NFlpIjyVhxRPJgmyKThb)

Give your App a relevant name, such as your website domain name, and select the Sandbox Business Account from the dropdown menu. Then, click "Create App."

![Creating a PayPal Sandbox Application](/files/gseFbfeNbzjTKSoNEbih)

You will then be presented with the credentials page. Copy the Client ID and Secret into the Payment Page plugin settings and click "Save Settings:"

![Entering PayPal Client ID and Secret into Payment Page plugin Settings](/files/jSC2qcbvrnzsUJRH3CHn)

That's it! You've configured the connection to your PayPal account.

{% hint style="info" %}
For other functionality to work properly, such as confirmation emails, please ensure you [configure PayPal webhooks](https://docs.paymentpageplugin.com/payment-gateways/paypal/paypal-webhook-configuration).
{% endhint %}

{% content-ref url="/pages/Bod2jfj6tc1jwfGhR9ks" %}
[PayPal Webhook Configuration](/payment-gateways/paypal/paypal-webhook-configuration.md)
{% endcontent-ref %}

Once you've configured the connection to your PayPal account in TEST mode, you may want to make test payments. To make test payments, you need to create a PayPal Personal Sandbox Account.

### Creating a Sandbox Personal Account

Go back to PayPal [Sandbox > Accounts](https://developer.paypal.com/developer/accounts) section, and click "Create Account:"&#x20;

Under "Account Type" leave the selection for "Personal (Buyer Account)" and select your corresponding country:

![Create Personal Sandbox PayPal Account](/files/WZrfL9OW92DrQtX8KPiO)

Under the Manage Accounts column, click the 3 dots menu and select "View/Edit Account."

Change the password so you know what it is, as it is randomly designated by PayPal at first.&#x20;

When making TEST payments with PayPal, use these credentials for the Buyer account when prompted to login.&#x20;

## PayPal Live Mode Configuration

{% hint style="info" %}
The setup process is exactly the same for both TEST and LIVE modes - just ensure you've clicked either "Sandbox" or "Live" at the top of the [PayPal My Apps & Credentials](https://developer.paypal.com/developer/applications) section.&#x20;
{% endhint %}

For live mode configuration, you only need to create a new Live Application. You don't need a Sandbox Business Account to receive payments in LIVE mode.&#x20;

The Live Application credentials should be entered into the Payment Page plugin settings along with your primary PayPal email address.

{% hint style="success" %}
If you have any questions or get stuck anywhere, please email us at <support@gauchoplugins.com>.&#x20;
{% endhint %}


---

# 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.paymentpageplugin.com/payment-gateways/paypal/paypal-setup.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.
