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.
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.
The transaction flow shows the different ways a transaction can be processed. This differs per payment method.
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.
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.|
|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.
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.
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.
paypal_api1.multisafepay.comin the Third-Party Permission Username field. Click on Lookup
The following options can be accessed:
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:
Click on the following page
Choose Western European Languages (including English)
Click on More Options –> UTF-8
Click Yes –> Save
Click on the gear icon in the upper right corner and select Account Settings -> Business information.
PayPal Merchant ID
Log in into your MultiSafepay Control
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.
The refund of a PayPal transaction can be processed from within your MultiSafepay Control
Please follow these steps:
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.