PayPal, How does it work?

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:

PayPal transaction flow

Order Status Financial 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 Canceled Transaction has been canceled.

PayPal transaction, refund status flow

Order Status Financial Status Description
Reserved Initialized A refund has been requested.
Completed Initialized Refund has been successfully processed.

Full API reference on the payment method PayPal.

Product rules

Some rules may apply to certain payment methods. These rules apply to the payment method PayPal.

  • A payment link with the payment method PayPal is valid for 14 days. The lifetime of the payment link is set by PayPal. Therefore, a payment link created with the payment method PayPal will automatically expire after 14 days.

    The lifetime of PayPal exceeds the lifetime of MultiSafepay, unless the lifetime falls below the 14 days

    Full documentation on the lifetime of a payment link can be found on our FAQ page, Lifetime of a payment link

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

  • A successful payment received within your PayPal account can be refunded within 90 days. Normally a credit card payment can be refunded within 180 days. If a refund still needs to take place, a bank transfer is advised.

  • For information on which currencies are supported within the payment method PayPal, please contact PayPal.