Connecting PayPal Commerce

PayPal is deprecating its previous products (Business, Business Pro, and PayFlow) and moving all merchants to PayPal Commerce. If you have already signed up with PayPal Commerce you will not have to go through onboarding again. New merchants, or merchants upgrading, are guided through PayPal's onboarding process and may need to complete extra steps with PayPal to finalise the account.

Connecting to PayPal Commerce is an OAuth process. It requires you to log into PayPal, which then shares a security token with us. To complete this you need a PayPal login with administrator access on your PayPal account.

1. When prompted, select Connect PayPal Commerce to log in to your PayPal Commerce account.

   

2. A popup asks which product you are connecting:

   • PayPal Commerce Platform: The usual choice. This makes the Pay by PayPal button available in checkout. Depending on your region and settings, Pay Later, Venmo, and card payments display alongside the PayPal button. With this option you only see that the customer "Paid with PayPal".
   • Advanced Card Payments and PayPal via PayPal Commerce Platform: This requires an additional application process. It gives a more native card capture flow, more visibility over how the customer paid, and may carry different processing fees.

   

3. If you have not recently been logged into PayPal you will be prompted with a login screen. Log in as an administrator of the account.

   📘

   Tip

   On the PayPal authorization screen, the application requesting access appears as "Shuttle Global".

   

4. You may be prompted to allow "Shuttle Global" to access your account, which you should do.

5. If this is a new PayPal account, or you requested Advanced Card Payments and have not had it activated on your account before, PayPal may request additional company information. Note that at this point you are on the paypal.com website, and this information is being requested by PayPal, not by us.

   

6. When you are returned to the app, the connection is tested and you are shown a green "Connected to PayPal Commerce" message. If there is an error with the connection, use the Reconnect button — but take care to connect to the same account, otherwise saved payment methods and refunds will return an error message.

   

Connection options

Our integration with PayPal offers several options:

• Enable Reference Transactions: Allows customers to save their payment method. This is not available on accounts by default — you must contact PayPal and have the facility enabled before selecting the checkbox, otherwise it will not work.
• Enable Fraudnet: Enables PayPal's Fraudnet product. When selected, it presents a Fraudnet URLs option (see below).
• Disable Venmo Button: Prevents Venmo from being presented by PayPal on eligible transactions.
• Disable Pay Later Button: Prevents Pay Later from being presented by PayPal on eligible transactions — for example, if you use a different buy-now-pay-later processor.
• Disable Cards Button: Prevents Pay by Credit / Debit Card from being presented by PayPal on eligible transactions — for example, if you use a different card processor.
• Require AVS: Appears only for accounts with Advanced Card Payments activated. Requires the customer to enter a billing address to process a payment.

📘

Tip

There are many reasons Venmo might not display even when enabled. See PayPal's Pay with Venmo documentation for details.

Fraudnet URLs

When Enable Fraudnet is selected, you must register each domain that payment pages will be hosted on with PayPal:

1. Use the Add button to add any additional domains you have.
2. Select Download to download a sample email containing your configuration settings.

3. Share the downloaded email with PayPal support to have Fraudnet activated for your domains.