# PayPal

## General Information

The globally operating payment provider PayPal enables customers to send and receive payments securely and quickly online. Online merchants can integrate PayPal into their website to allow customers to pay via credit card, bank transfer, and PayPal balance.

### Links <a href="#links" id="links"></a>

* [Login](https://www.paypal.com/signin?country.x=US\&locale.x=en_US) at PayPal
* PayPal [Website](https://www.paypal.com/us/webapps/mpp/home)

## Features <a href="#features" id="features"></a>

### Payment types

The following features are available in the Payrexx merchant administration panel:

* ✅ One-time payments
* ✅ Refunds
* ✅ Partial refunds
* (✅) Recurring payments (Subscription)
* (✅) Tokenizations
* ❌ Pre-authorizations

## Country Availability

PayPal is available in [more than 200 countries](https://www.paypal.com/us/webapps/mpp/country-worldwide) around the world, including all countries of the :flag\_eu: European Union and :flag\_ch: Switzerland.

### Restrictions on subscriptions and tokenizations

Please note that recurring payments (subscriptions) and tokenizations with PayPal are only possible if the PayPal account is registered in one of the following countries:

|                           |                          |                           |
| ------------------------- | ------------------------ | ------------------------- |
| :flag\_au: Australia      | :flag\_de: Germany       | :flag\_no: Norway         |
| :flag\_at: Austria        | Hong Kong                | :flag\_pl: Poland         |
| :flag\_be: Belgium        | :flag\_hu: Hungary       | :flag\_pt: Portugal       |
| :flag\_bg: Bulgaria       | :flag\_ie: Ireland       | :flag\_ro: Romania        |
| :flag\_ca: Canada         | :flag\_it: Italy         | :flag\_sg: Singapore      |
| :flag\_cn: China          | :flag\_jp: Japan         | :flag\_sk: Slovakia       |
| :flag\_cy: Cyprus         | :flag\_lv: Latvia        | :flag\_si: Slovenia       |
| :flag\_cz: Czech Republic | :flag\_li: Liechtenstein | :flag\_es: Spain          |
| :flag\_dk: Denmark        | :flag\_lt: Lithuania     | :flag\_se: Sweden         |
| :flag\_ee: Estonia        | :flag\_lu: Luxembourg    | :flag\_gb: United Kingdom |
| :flag\_fi: Finland        | :flag\_mt: Malta         | :flag\_us: United States  |
| :flag\_fr: France         | :flag\_nl: Netherlands   |                           |

## Fees

When integrating PayPal as an external payment provider in Payrexx, an additional transaction fee from Payrexx applies on top of PayPal’s fees. This fee ranges between 0.25% and 1.00%, depending on the selected plan.

For more information, please visit our website:

{% embed url="<https://payrexx.com/en/prices>" %}

## Setup

This article explains how to integrate PayPal as an external payment provider in Payrexx to receive payments.

### Configuration of PayPal

{% hint style="info" %}
If your country (for example :flag\_ch: Switzerland) does not appear in the country selection at PayPal, simply scroll to the top of the selection field and select "Country or region".
{% endhint %}

* Visit the PayPal [website](https://www.paypal.com/).
* Click on "Sign Up" at the top right.
* Select whether it is a personal or business account and click on "Get Started".
* Enter your personal information, choose a secure password, and click on "Agree and Create Account":

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FrnOQWZ3QrerZ5Xk6UALb%2Fimage.png?alt=media&#x26;token=b9254d3e-0b67-456d-9583-621a4e53408c" alt="" width="563"><figcaption><p>Creating an account with PayPal</p></figcaption></figure></div>

### Configuration of Payrexx

{% hint style="info" %}
Make sure you're [logged in](https://login.payrexx.com/) to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can [register](https://signup.payrexx.com/) now.
{% endhint %}

* Navigate to "Payment Providers" in your Payrexx account.
* Depending on whether PayPal has been used before or not, click either the green "Setup" button or the white "Configure" button next to PayPal:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FLzdVuBFpKhXRXHXOrMY9%2Fimage.png?alt=media&#x26;token=74b19437-c80e-4f0c-982d-3b307d268667" alt=""><figcaption><p>Start the configuration of PayPal by clicking the "Setup" button</p></figcaption></figure></div>

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FZB8IjGRrYVncqP4VNP92%2Fimage.png?alt=media&#x26;token=0edafb8b-e62d-4f6a-98dd-46c69e153d7a" alt=""><figcaption><p>Start the configuration of PayPal by clicking the "Configure" button</p></figcaption></figure></div>

* If you do not have a PayPal account yet, you can create one now by clicking on "Yes". If you already have an account, click on "No, not now":

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FFs8q4cuIyTj5q9yMvzjU%2Fimage.png?alt=media&#x26;token=52dde758-53b0-4041-a58e-d94ee6ded745" alt="" width="563"><figcaption><p>Option to create a PayPal account</p></figcaption></figure></div>

The PayPal configuration screen will open, where you can make the following settings:

1. Define whether you want to receive live payments through PayPal or set PayPal to [test mode](https://docs.payrexx.com/merchant/english/payment/testing).
2. Enable the currencies in which you want to receive payments via PayPal.
3. Click on "Connect PayPal account" next to Productive account settings if you want to use PayPal in live mode.
4. Click on "Connect PayPal account" next to Sandbox account settings if you want to use PayPal in test mode.

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FHXHw0da9RtIw1Nr82W4N%2Fimage.png?alt=media&#x26;token=e1dc4b85-5b02-405a-9b70-02a1376cfe46" alt=""><figcaption><p>PayPal settings in Payrexx</p></figcaption></figure></div>

{% hint style="info" %}
If your country (for example :flag\_ch: Switzerland) does not appear in the country selection at PayPal, simply scroll to the top of the selection field and select "Country or region".
{% endhint %}

* Confirm that you are a human by completing the PayPal security check.
* Enter the email address of your PayPal account and your country, then click "Next".
* Log in with your password.
* Follow the on-screen instructions to complete your account.
* Click the blue button to return to Payrexx.
* Your PayPal account is now connected to Payrexx:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FMDfb5xxdUmKnxzF4p9U0%2Fimage.png?alt=media&#x26;token=a7153bde-a9e6-4e99-838a-658643845bf7" alt="" width="437"><figcaption><p>PayPal and Payrexx are connected</p></figcaption></figure></div>

* Complete the configuration by clicking on "Save" in the bottom right corner.

{% hint style="success" %}
Your account is set up, and you can now receive payments with PayPal.
{% endhint %}

## Payouts

As PayPal is an [external payment provider](https://docs.payrexx.com/merchant/english/payment-provider/external-payment-provider), payouts are not processed through Payrexx. Transactions received via PayPal are paid out to you directly by PayPal.

If you have any questions regarding the payout of PayPal transactions, please contact PayPal Support:

{% embed url="<https://www.paypal.com/us/cshelp/contact-us>" %}

## Payment Process with PayPal

From the customer's perspective, payments with PayPal follow the process below.

1. The customer selects PayPal as the payment method:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2Fd80SuAFAzaBo5IGxgr8J%2Fimage.png?alt=media&#x26;token=dab95d6b-3540-4170-8b13-779f7973fa9d" alt="" width="395"><figcaption><p>Selecting PayPal as the payment method</p></figcaption></figure></div>

2. The customer is redirected to PayPal:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FSdiPvBiMQC7NpnLJx9qc%2Fimage.png?alt=media&#x26;token=ca3e3532-f60b-429a-abb2-1488639f891d" alt="" width="371"><figcaption><p>Redirection to PayPal</p></figcaption></figure></div>

3. The customer logs in to PayPal using their credentials:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F76TgFZMhQDAzw4orAPBA%2Fimage.png?alt=media&#x26;token=ffc7c414-089d-44fa-91d6-9881ce61cd25" alt="" width="450"><figcaption><p>Logging in to PayPal</p></figcaption></figure></div>

4. The customer completes the payment with PayPal by clicking the blue button:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FI7f2kY2E4Bhx1EPIAIGZ%2Fimage.png?alt=media&#x26;token=c69129cc-964d-488d-8259-c772a9e84286" alt="" width="356"><figcaption><p>Completing the Payment with PayPal</p></figcaption></figure></div>

5. After the successful payment, the customer is redirected back to Payrexx:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FD1ueS2yKRwDhRXDYHdxs%2Fimage.png?alt=media&#x26;token=a8cacf09-a855-4fa5-82c6-560cebb35d98" alt="" width="267"><figcaption><p>Confirmation of the PayPal payment</p></figcaption></figure></div>