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

Read how PayPal can benefit your business on

For more information, see PayPal – PayPal supported currencies .
Payment componentsYes
Payment pagesYes (current and deprecated versions)
RefundsYes: Full and partial (see guidance below)
Second ChanceYes

Payment flow

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

PayPal payment flow


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.

DescriptionOrder statusTransaction status
The customer has been redirected to PayPal.InitializedInitialized
Awaiting the customer to pay in their PayPal account, or
PayPal is authorizing the transaction, or
You may need to enable the currency and then authorize the payment in your PayPal business account.
PayPal has collected payment.CompletedInitialized
The customer cancelled the payment in PayPal.VoidVoid/Cancelled
The customer didn't complete payment within 14 days.ExpiredExpired
Refunds: Refund initiated.ReservedInitialized
Refunds: Refund complete.CompletedInitialized
Refund declined.DeclinedDeclined
PayPal is authorizing the refund, or
There are not enough funds in your PayPal business account to process the refund.
For more information, see your PayPal business account.


To activate PayPal, follow these steps:

How to configure your PayPal account

To configure your PayPal account, follow these steps:

  1. Sign in to your business account at PayPal .
  2. Mouse over your account name in the top-right corner, and then select Account settings.
  3. On the Account access tab, under API access, click Update.
  4. Under Pre-built payment solution, click Grant API permission.
  5. In the Third-party permission username field, enter
  6. Click Lookup.
  7. Select the checkboxes of the relevant permissions:
    • 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.

To complete the configuration, change the language encoding setting of your PayPal account to UTF-8:

  1. Click PayPal – Profile language encoding .
  2. Next to Language coding for PayPal buttons, click Edit.
  3. From the list, select Western European languages (including English).
  4. Click More options.
  5. From the Encoding list, select UTF-8.
  6. Select the Yes checkbox, and then click Save.

💬 Support: If the payment method isn't visible in your dashboard, email [email protected]


Known error

If your PayPal business account isn't yet fully verified or approved, you might get a PayPal error 10002: Restricted account.

How to configure your MultiSafepay account

To configure your MultiSafepay account for PayPal, follow these steps:

  1. Sign in to your business account at PayPal .
  2. 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 activate PayPal for:
    • All your sites, go to Settings > Payment methods, and then select the PayPal checkbox.
    • A specific site:
      • Go to Integrations > Sites, and then click the relevant site.
      • Under Payment methods, click Select payment methods.
      • Select the PayPal checkbox, and then click Save changes.
  6. In the PayPal dialog, in the PayPal merchant ID field, paste your ID.
  7. Click Save changes.


  • You can link each site to a separate PayPal business account, or all sites can use your main PayPal business account.
  • If PayPal isn't visible as a payment method in your dashboard, email [email protected]


Your account is now configured!

We strongly recommend testing transactions before processing live payments.



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

  • Transactions expire after 14 days.

Ready-made integrations

Supported in all ready-made integrations.


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.


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 .

Your logo in PayPal's checkout

You can display your logo in the PayPal checkout to increase brand recognition and trust.

How to display your logo in PayPal's checkout

To display your header or logo on the PayPal checkout page, follow these steps:

  1. Sign in to your MultiSafepay dashboard .
  2. Go to Settings > Files, and upload the relevant images.
  3. Go to Payment methods at the bottom right, and then select the relevant images from the Logo and Header list.
  4. Click Save.



Email [email protected]

Top of page