⚠️

Action required

If you have an existing PayPal account connected to your MultiSafepay dashboard, we recommend you to upgrade to the latest PayPal API as soon as possible.

Under the latest PayPal API, you can:

• Add an invoice_id in your request.
• Add a shopping cart in your request.
• Integrate the PayPal smart button.

PayPal is a leading global payment method that lets customers pay by credit or debit card or create a digital wallet linked to multiple payment methods.

Read how PayPal can benefit your business on multisafepay.com

Payment flow

This diagram shows the flow for a successful transaction. Click to magnify.

ℹ

Note

MultiSafepay does not collect funds for PayPal transactions.

Payment statuses

The table below sets out the order status and transaction status for payments and refunds.

Activation

To activate PayPal, follow these steps:

How to configure your PayPal account

1. Email a request to [email protected]
2. After we confirm activation, sign in to your MultiSafepay dashboard .
3. Go to Settings > Payment methods
4. In the PayPal tab, click on Set up PayPal button
   You are redirected to PayPal to sign in to your PayPal business account.
5. Grant PayPal access to connect with your MultiSafepay account.
6. Your PayPal Merchant ID is now displayed in your MultiSafepay dashboard .

If your PayPal Merchant ID isn't displayed in your dashboard, you can add it manually.

How to add your PayPal Merchant ID

1. Sign in to your business account at PayPal .
2. On the navigation menu > mouse over your account name in the top-right corner, and then select Account settings.
3. On the Business information tab, copy your PayPal Merchant ID.
4. Sign in to your MultiSafepay dashboard .
5. To set manually your PayPal Merchant ID:

• Go to Settings > Payment methods> PayPal tab.
• Click add PayPal ID link at the bottom of PayPal tab.
• In the PayPal merchant ID field, paste your PayPal Merchant ID.
• Click Save changes.

✅ PayPal has been successfully configured in your MultiSafepay account.

📘

Note:

If you already have a PayPal account connected to MultiSafepay dashboard, we recommend upgrading to the latest PayPal API as soon as possible by following all the steps above. No other actions are required after this step.

We strongly recommend testing transactions before processing live payments.

Integration

API

• See API reference – Create order > Wallet order.

  Example requests

  
  

  For example requests, on the Create order page, in the black sandbox, see Examples > PayPal direct/redirect.

  

• A shopping_cart object can be included in your create order request, see Recipe – Include shopping_cart in order .

• An invoice_id can be included in your create order request, which appears in the transaction history.
  Note: If no invoice_id is set, the order_id defaults to invoice_id.

• Transactions expire after 14 days.

Ready-made integrations

Supported in all ready-made integrations.

Testing

To test PayPal payments, see Testing payment methods - Wallets.

---

User guide

PayPal Seller Protection

PayPal Seller Protection covers you in the event of claims, chargebacks, or reversals due to unauthorized purchases or items the customer didn't receive. You are covered for the full amount of all eligible transactions.

To be eligible, for specific countries, transaction requests must contain the correct state in the customer_address.

• For a list of the countries, see PayPal API – State codes .
• For more information, see PayPal – What is Seller Pretection .

⚠️ Note: For disputes and disbursement information, further details appear in a transaction note in your dashboard under Transaction overview > Transaction summary.

Refunds

Refunds are only processed if there are enough funds in your PayPal business account. Otherwise, PayPal issues an eCheck .

To avoid PayPal cancelling the refund, in your PayPal account, authorize PayPal to withdraw funds from another bank account instead.

For support, contact PayPal – Help Center Home .

Shopping carts

You can include shopping cart in your create order request, which is displayed on the PayPal checkout page, and PayPal communications.

Your logo in PayPal's checkout

You can no longer display your logo; your website name is displayed in the PayPal checkout.

Troubleshooting

If you encounter any issues with PayPal, for example a system error, do the following checks:

• You have upgraded to the latest PayPal API
• PayPal is activated for your account

---

Top of page