PayPal


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.

Payment type Payment flow Countries Currencies Refund options Recurring Chargebacks
Wallet Direct/Redirect Worldwide Multiple Full/Partial No Yes

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 ecommerce integrations 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.

Please note that MultiSafepay does not collect funds for PayPal

In PayPal, after a successful payment of a transaction, the order status is set to Completed and the financial status remains set to Initialized. If the financial status remains Initialized, an order cannot be delivered since the shipment of an order depends on the financial status. You must ensure that orders are set to Completed for both the order and financial status after a successful payment.
  • 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 Initialized 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:

  • To be eligible for PayPal Seller Protection, the transaction request needs to have the correct state in the customer address details for the following countries

  • 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.

Activate

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. Log in to https://www.paypal.com with your business account
  2. Click on the gear icon in the upper right corner and select Account Settings
  3. Select Account access and click Update behind API access
  4. Click on Grant API permission
  5. Enter paypal_api1.multisafepay.com in the Third-Party Permission Username field. Click on Lookup.
Please read: If any of these steps are inaccurate, please send an email to: [email protected]

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 OptionsUTF-8

  4. Click YesSave

MultiSafepay Control configuration

  1. Click on the gear icon in the upper right corner and select Account SettingsBusiness 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.

Do you want to show your header or logo at the checkout page in PayPal? First, upload the images under SettingsFiles. Next, navigate to payment methods at the bottom right-hand side, select the images as logo and header and click Save.

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.

Testing

For more information about the possibilities of testing with PayPal, please refer to our test payment details

Feedback

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

Feedback

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.