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.

When prompted, select Connect PayPal Commerce to log in to your PayPal
Commerce account.
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.
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".
You may be prompted to allow "Shuttle Global" to access your account, which
you should do.
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.
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:

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

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