What it is

PayPal is an international payment processing service that allows customers to pay by credit card or create a digital wallet linked to alternative payment methods. With a global reach, PayPal has been part of many businesses’ international expansion.

How it works

MultiSafepay supports seamless integration with PayPal with the PayPal API. Funds are transferred directly to the merchant’s PayPal business account, while the transaction statuses and payment validation are managed by MultiSafepay. In order to integrate your PayPal Business account with MultiSafepay, the PayPal account API settings must be configured. Once the integration is completed, you can receive payments through this gateway by using one of our plugins or by implementing a custom integration with our API.

The transaction status refers to the status of the actual payment. MultiSafepay uses the order status for PayPal transactions. Since we do not collect the funds of completed PayPal transactions (as they are directly sent to your PayPal account), the financial status will remain initialized.

Please note the various descriptions of statuses and how they should be interpreted.

Transaction flow

The transaction flow shows the different ways a transaction can be processed. This differs per payment method.

  • Order status
    The order status indicates the status of the order, such as completed, pending or rejected. The order status is independent of the incoming or outgoing payment of the transaction.

  • Transaction status
    The transaction status indicates the payment status of the transaction, such as completed, pending or rejected. Once the transaction status is completed, the amount of the transaction is added to your MultiSafepay balance.

Order Status Transaction Status Description
Initialized Initialized A payment link has been generated, but no payment has been received yet.
Completed Initialized A successful PayPal transaction has been received and the funds will be added to your PayPal balance.
Declined Declined Transaction has been rejected
Expired Expired An unfinished transaction will automatically expire after a predefined period.
Void Cancelled Transaction has been cancelled.
Uncleared Uncleared An ‘Uncleared’ transaction without a reason is due to a configuration in your PayPal business account. The ‘Uncleared’ transactions are paid in a currency that is not enabled in your PayPal account. It is important to enable that specific currency in your PayPal account in order for the order status to change to ‘Completed’ in your MultiSafepay Control.

Refund flow

Order Status Transaction Status Description
Reserved Initialized A refund has been requested.
Completed Initialized Refund has been successfully processed.
Uncleared Uncleared Refund has been initiated but PayPal account funds are insufficient. Refund will only be processed if funds are present.

View the full API reference for PayPal and credit cards.

What is Seller Protection

PayPal Seller Protection covers you in the event of claims, chargebacks, or reversals that are a result of unauthorized purchases or items your buyer did not receive. With PayPal Seller Protection, you are covered for the full amount of all eligible transactions.

Full documentation on What is Seller Pretection with PayPal transactions.

Product rules

Some rules may apply to certain payment methods. For PayPal, the following rules apply:

  • Refunding more than the stated amount of the original transaction is not possible for PayPal. More information is available on our refund more than original amount page

  • Successful PayPal transactions have a maximum refund period of 60 days. After this period, it is advised to process the requested refund by different means

  • A PayPal payment link is valid for 14 days. The lifetime of the payment link is set by PayPal. Therefore, a payment link created with PayPal will automatically expire after 14 days. Full documentation can be found on our lifetime of a payment link FAQ page

  • Uncleared transactions can only be declined or accepted within your PayPal account

  • Refunds will be processed only when your PayPal account balance is sufficient

  • For information on which currencies are supported, please contact PayPal.


These instructions are in English. If your PayPal webpage is in another language, you can change the language easily with the links at the rightside bottom of any page.

Account configuration

  1. Login into with your business account
  2. Navigate to Toolsv-> All tools -> API credentials
  3. Click on the leftside of the menu –> Integrate PayPal
  4. Click on Grant API permission
  5. Enter in the Third-Party Permission Username field. Click on Lookup

The following options can be accessed:

  • Use Express Checkout to process payments
  • Issue a refund for a specific transaction
  • Process your customers credit or debit card payments
  • Obtain information about a single transaction
  • Obtain authorization for pre-approved payments and initiate pre-approved transactions
  • Use Express Checkout to process mobile payments.

In order to ensure a correct integration with PayPal, you must change the language encoding setting of your PayPal account to UTF-8.

To do this, please follow the steps below:

  1. Click on the following page

  2. Choose Western European Languages (including English)

  3. Click on More Options –> UTF-8

  4. Click Yes –> Save

MultiSafepay Control configuration

  1. Click on the gear icon in the upper right corner and select Account Settings -> Business information.

  2. Copy your PayPal Merchant ID

  3. Log in into your MultiSafepay Control

  4. Navigate to Settings->Payment methods. Select ‘PayPal’ and enter your PayPal Account ID.

Your account is now configured and you are ready to accept MultiSafepay payments. We strongly recommend you perform one or more test transactions in order to ensure everything is working correctly.

If PayPal is not visible as a payment method in your MultiSafepay Control account, please contact the Integrations team at [email protected] to assist you further.

Please note that if you have enabled payment methods on a particular website, you should also enable PayPal for that specific website.

Request refund

The refund of a PayPal transaction can be processed from within your MultiSafepay Control

Please follow these steps:

  1. Select Transactions -> Transaction overview
  2. Find the transaction through search
  3. Open the transaction
  4. Select refund
  5. Fill in the amount that you are going to refund to the customer
  6. Confirm.

Please note that by default, MultiSafepay does not allow for you to refund more than the stated amount of the original transaction. Please refer to the product rules for more information.

  • The transaction status is now initialized. As long as the transaction status is marked as initialized, the refund can be cancelled. When the transaction status is marked as completed, the refund is processed correctly. The customer will receive the refund to the bank account number in which the transaction was originally paid to, within the next business day

  • PayPal transactions can be refunded within 60 days

  • A refund will only be processed if your PayPal balance is sufficient. Otherwise, PayPal will proceed with issuing an eCheck You will need to make sure that PayPal is authorized to withdraw funds from a linked bank account when a refund is requested and your balance is insufficient, in order to avoid a potential cancellation on PayPal’s side. As a merchant, you will need to take care of these settings yourself, from within your PayPal account. Failing to do so can result in a cancelled refund and follow-up complaints and escalation from your customers. For any questions related to this topic, we strongly encourage you to reach out to PayPal’s support.


You're missing something out and would like us to fix it? Suggest an improvement to this page!


Other languages

Liever uitleg in het Nederlands? Neem contact op met uw accountmanager.

Vuoi ricevere informazioni in italiano? Contatta il tuo account manager.

Falls Sie eine deutschsprachige Erklärung bevorzugen, kontaktieren Sie bitte Ihren Kundenbetreuer

Prefieres tener la explicación en Español? Contacta con tu gerente de cuentas.

Vous préférez une explication en français? Contactez votre gestionnaire de compte.