# 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](https://1515224304-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McBG1PRKZyYYj_bIAX0%2Fuploads%2FBs0mZX7cHKsJGykHbkU2%2Fcreating-sandbox-paypal-account.png?alt=media\&token=7d7d9a85-2db1-40f8-8f1e-6855133b6d51)

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

![Creating a Sandbox Business PayPal account](https://1515224304-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McBG1PRKZyYYj_bIAX0%2Fuploads%2Fuxn3d8LSlks6wxwOJ7ee%2Fsandbox-business-merchant-account-creationg-paypal.png?alt=media\&token=c11b8fe5-bb3a-4978-970a-076551122bb4)

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](https://1515224304-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McBG1PRKZyYYj_bIAX0%2Fuploads%2FkWiIA3wG9jR2WiL9Lxmz%2Fpaypal-sandbox-business-account-settings.png?alt=media\&token=4105c19e-a237-48c7-902e-aaf861483222)

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](https://1515224304-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McBG1PRKZyYYj_bIAX0%2Fuploads%2FeDqghsk6ZbExYxYPCuNv%2Fcreate-paypal-sandbox-app.png?alt=media\&token=52b25461-6b22-4007-afaa-3374a1386bcf)

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](https://1515224304-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McBG1PRKZyYYj_bIAX0%2Fuploads%2FkzoJyp2wEegJR6tCMqUi%2Fcreating-paypal-sandbox-application.png?alt=media\&token=c3bea89d-9dad-4701-bf83-8e8dc539674f)

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](https://1515224304-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McBG1PRKZyYYj_bIAX0%2Fuploads%2Fi94cskYWSZZ8augJuew2%2Fentering-client-id-secret-payment-page-settings.png?alt=media\&token=3a22a6d2-8b18-4772-bea9-f9a2ebc74163)

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="paypal-webhook-configuration" %}
[paypal-webhook-configuration](https://docs.paymentpageplugin.com/payment-gateways/paypal/paypal-webhook-configuration)
{% 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](https://1515224304-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McBG1PRKZyYYj_bIAX0%2Fuploads%2F0IqHs09GSYbt5oNYDLpF%2Fcreate-sandbox-personal-account.png?alt=media\&token=8ba1fc9f-dbcf-4f63-9b16-99dd4f37c9e5)

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 %}
