# PayPal
Paypal payments can be processed with Saferpay without much effort. This chapter describes what needs to be considered in this regard.
## General requirements
The handling of PayPal payments with Saferpay requires:
* A [corresponding license ](https://docs.saferpay.com/home/master/licensing)and thus a valid identification with a username and password for the Saferpay system.
* Availability of at least one active Saferpay terminal via which payment can be carried out and availability of the associated Saferpay TerminalId.
* A valid PayPal merchant account.
### Technical requirements
The general integration of PayPal can only be done via the [Payment Page](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/payment-page) and requires the following things to be noted:
* PayPal requires the `Payment.OrderId` to be unique. Saferpay however does not limit the use of the **OrderId** in any way. If you use PayPal, you have to make sure, that your system submits unique OrderIds for every PayPal-transaction, otherwise you will get an error-message during the authorization.
{% hint style="danger" %}
PayPal does not support the[ iFrame Integration](https://docs.saferpay.com/home/integration-guide/general-information/iframe-integration-and-css)\.
{% endhint %}
* Unlike normal transactions, PayPal refunds always have the status **CAPTURED**, thus executing the money right away.
* The notification URLs, inside the`Notification` conatiner are **mandatory**, in order to avoid missing payment successes. See the [Payment Page process](https://docs.saferpay.com/home/licences-and-interfaces/payment-page#notification.successnotifyurl-and-notification.failnotifyurl) for further information.
### Supported features
| Feature | Support |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-----: |
| [Capture](https://docs.saferpay.com/home/licences-and-interfaces/capture-and-daily-closing#capture)/[Cancel](https://docs.saferpay.com/home/licences-and-interfaces/capture-and-daily-closing#cancel) | ✅ |
| [Multipart Captures](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/capture-and-daily-closing/partial-captures) | ✅ |
| Secure Card Data ([Needs Attention](#paypal-vault)) | ✅ |
| [Refunds](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/transaction-interface/refunds) | ✅ |
| Recurring Payments ([Needs Attention](#paypal-vault)) | ✅ |
| 3D Secure | ❌ |
| Dynamic Currency Conversion (DCC) | ❌ |
| Mail Phone Order | ❌ |
| [Testing](#testing) | ✅ |
| Omni-Channel | ❌ |
| [PayPal Seller Protection](#paypal-seller-protection) | ✅ |
| [Express Checkout](#express-checkout) | ✅ |
{% hint style="info" %}
PayPal refunds do not need to be captured and will always report a **`Transaction.Status: "CAPTURED"`**.
{% endhint %}
## Activation
To enable Paypal processing on your Saferpay Terminal, there are two steps, that need to be done
### #1 - Activation on your Saferpay Terminal
First and foremost, PayPal needs to be activated on your desired terminal.
For that, please [**inform our customer service**](https://docs.saferpay.com/home/support#customer-services) about the terminal-Id(s) you want PayPal to be activated on, your PayPal merchant account ID(s) and the desired currencies.
### #2 - Granting permission to Saferpay
Once step #1 has been done, you have to grant Saferpay the permission to perform actions (e.g. transactions of any kind) on your PayPal account.
For that, please log into the Saferpay Backoffice and navigate to [**Settings >** **Payment Means & Terminals**](https://docs.saferpay.com/home/interfaces/backoffice/settings#payment-means-terminals). There, please select any terminal to activate PayPal on your Saferpay account. This activation applies to the entire Saferpay account, meaning there is no need to activate it separately on each terminal.
It is possible to use a separate PayPal account for each terminal, provided that these have been enabled in step 1.
Scroll down, until you find PayPal and click on **`Configure`**.
The activation status window will open up. Since no activation has been performed, you will be asked to finalize it now. In order to do so, please click on **`Connect a PayPal account`**.
You will be redirected to PayPal, where you'll be asked to log in with your merchant account and grant the necessary permissions for Saferpay, including [PayPal Vault](#paypal-vault).
{% hint style="warning" icon="triangle-exclamation" %}
This account must be the same, you have forwarded to our customer service.
{% endhint %}
All done, PayPal has now been activated and you can return to the Saferpay Backoffice:
Otherwise, a screen like this will appear, and you will need to follow the instructions. A failed onboarding process will not be stored and you need to perform it again:
### Checking the activation status
You can check the current status, by clicking on **`Configure`** again.
Saferpay will show you an overview about the activation and availability of certain PayPal features, like [PayPal Vault](#paypal-vault).
{% hint style="info" %}
If this activation and configuration is not completed successfully, PayPal will not appear as a payment method on the Saferpay payment page.
{% endhint %}
## Capture and the solvency of the customer
Unlike credit cards, that give the merchant a certain guarantee for the authorized money, PayPal reserves the right to deny the payout of a transaction, if the solvency of the account holder changes negatively after the authorization.
Therefore Saferpay claims the money directly, once the [Capture](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/capture-and-daily-closing) of the transaction has been successfully executed. If the money cannot be claimed, the capture then returns an error. We generally recommend to execute the [Capture](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/capture-and-daily-closing) as soon as possible, to avoid any issues.
## PayPal Seller Protection
The PayPal Seller Protection protects eligible transactions from chargebacks, reversals and their associated fees.
### Requirements
From Saferpay side, you mus set both the Billing- and Shipping Addres, by [either using the built in Payment Page forms, or submitting the address yourself](https://docs.saferpay.com/home/licences-and-interfaces/payment-page#controlling-the-address-source) (the latter is recommended).
### Saferpay Response
Saferpay will return the Seller protection status with the [Payment Page Assert response](https://docs.saferpay.com/home/licences-and-interfaces/payment-page#id-4-paymentpage-assert) inside the **`PaymentMeans.PayPal.SellerProtectionStatus`** parameter.
The **`SellerProtectionStatus`** can have three values:
* Eligible
* Partially Eligible
* Not Eligible
\
More information about the PayPal Seller Protection you will find on the PayPal Documentation [here](https://www.paypal.com/bs/webapps/mpp/security/seller-protection)
## Express Checkout
Saferpay offers a way to implement a so called "Express Checkout", which allows the merchant to gather every important information about the payer -like addresses etc.- from the payment gateway, without the need of capturing this data yourself.
The payer could go through a guest-checkout, pays his order and everything needed for the merchant is returned at the end.
This minimizes user-interaction, makes the checkout sleek and fast, which increases the user-satisfaction.
Please [refer to this chapter](https://docs.saferpay.com/home/licences-and-interfaces/payment-page#express-checkout), in order to know, how you integrate an Express Checkout.
## PayPal Vault
PayPal Vault is a way to save a PayPal account for [Recurring Payments](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/transaction-interface/recurring-payments). It works via the normal Saferpay [Secure Card Data Tokenization](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/secure-card-data), either via [the Payment Page](https://docs.saferpay.com/home/licences-and-interfaces/secure-card-data#secure-card-data-and-the-payment-page), or the [Standalone registration](https://docs.saferpay.com/home/licences-and-interfaces/secure-card-data#standalone-secure-card-data-registration).
{% hint style="warning" %}
Please make sure, that [Vault has been successfully activated](#checking-the-activation-status) on your account.
{% endhint %}
### Standalone Registration
With the [Standalone registration](https://docs.saferpay.com/home/licences-and-interfaces/secure-card-data#standalone-secure-card-data-registration), you need to specify, that you want to register a PayPal account, by setting the **`Type`** parameter to **`"PAYPAL"`**, The rest of the flow remains the same.
#### Example of Alias Insert Request
{% tabs %}
{% tab title="Request" %}
```json
{
"RegisterAlias": {
"IdGenerator": "RANDOM_UNIQUE"
},
"Type": "PAYPAL",
"LanguageCode": "en",
"RequestHeader": {
"SpecVersion": "[CURRENT_SPEC_VERSION]",
"CustomerId": "[YOUR_CUSTOMER_ID]",
"RequestId": "5f543be575b3f3ecff3214257ac6978a",
"RetryIndicator": 0,
"ClientInfo": {
"ShopInfo": "My Shop",
"OsInfo": "Windows Server 2013"
}
},
"ReturnUrl": {
"Url": "https://www.myshop.com/return"
},
"Notification":{
"NotifyUrl": "https://www.myshop.com/notify"
}
}
```
{% endtab %}
{% tab title="Response" %}
```json
{
"ResponseHeader": {
"SpecVersion": "[CURRENT SPEC_VERSION]",
"RequestId": "5f543be575b3f3ecff3214257ac6978a"
},
"Token": "y6678qfw3dm9pule1inqkpr1o",
"Expiration": "2026-03-26T14:39:16.642+01:00",
"Redirect": {
"RedirectUrl": "https://test.saferpay.com/vt2/api/register/paypal/242225/y6678qfw3dm9pule1inqkpr1o",
"PaymentMeansRequired": true
}
}
```
{% endtab %}
{% endtabs %}
## Testing
Please refer to [this chapter](https://docs.saferpay.com/home/testing-and-go-live#paypal), if you want to test PayPal.
---
# 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.saferpay.com/home/integration-guide/payment-methods/paypal.md?ask=
```
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.
