# 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 wit

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.

   ![Connect PayPal Commerce dialog](/_astro/cdn/887220ece9/connect-1.png)

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.

   ![Choose which PayPal product to connect](/_astro/cdn/1d44d8feb2/connect-2.png)

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.

   :::note[Who is Shuttle Global?]
   On the PayPal authorization screen, the application requesting access appears as **"Shuttle Global"**. Shuttle Global is the integration platform that connects your payment provider to the software you use to take payments.
   :::

   ![PayPal account login / sign-up screen](/_astro/cdn/f25cfd5bcd/connect-3.png)

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](https://www.paypal.com) website, and this information is being
   requested by PayPal, not by us.

   ![PayPal approval confirmation screen](/_astro/cdn/9cd5892d24/connect-4.png)

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.

   ![Connected to PayPal Commerce confirmation with configuration options](/_astro/cdn/85df4be244/connect-5.png)

## Connection options

Our integration with PayPal offers several options:

- **Enable Reference Transactions (required to save card):** 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 address (AVS):** Appears only for accounts with advanced card
  processing (**Account Type** shows **PayPal with Advanced Card Processing**). Requires
  the customer to enter a billing address to process a card payment. On by default.

:::note[Tip]
There are many reasons Venmo might not display even when enabled. See PayPal's [Pay with Venmo](https://developer.paypal.com/docs/checkout/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.

![Fraudnet configuration panel with URLs and download button](/_astro/cdn/46e35a928d/connect-6.png)

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

![Sample Fraudnet support email template for PayPal](/_astro/cdn/5529badb30/connect-7.png)