PayPal Commerce Checkout

Add your PayPal Commerce gateway to CheckoutChamp so you can use it across all campaigns.

• Add Gateway to CRM

• Register or Migrate PayPal Gateway

• Use PayPal on Checkout and Upsell Pages

• Using the Test Server

• Special Considerations

---

Add Gateway to CRM

Navigate to Gateways → Gateway Integrations, then locate the PayPal Commerce tile. Click on the tile and press the + Activate button.

Enter a Title and optionally the brandName. Do not enter merchantId. merchantId will be automatically assigned in the next step.

Save the gateway and move onto the Register or Migrate PayPal Gateway instructions below.

The Accepted Payments and Additional Options sections will not affect PayPal gateways, but be sure to enter Limits and Gateway Details.

secure3DS - Choose this option if accepting credit cards through PayPal and are in need of 3D Secure protection (Strong Customer Authentication)

force3DS - Check this box to require 3D Secure on all credit card payments. An unchecked box will use 3D Secure only when the issuing bank requires it.

guestCheckout - Will redirect the customer to PayPal’s guest checkout page instead of the PayPal login page

useTestServer - use sandbox credentials to test the integration. Be sure this is unchecked for live processing. Using sandbox credentials on a live account will result in an error reading “Client Authentication failed”. See here for more details.

referenceTransactions - Required if using PayPal for upsells and/or recurring billings

sendFulfillmentTrackingNumber - CRM will send the tracking numbers for orders to PayPal

skipAddressNonShippable - If there are only digital products on an order then do not require selection of a delivery address at PayPal

If your account requires FraudNet, please be sure to send the FraudNet data when calling Import Order and Confirm PayPal APIs using the paypalClientMetadataId field.

Register or Migrate PayPal Gateway

Find the PayPal gateway in the list and press the Edit button on that row.

Press the Register or Migrate button (depending on if you are creating a new PayPal gateway or migrating a legacy PayPal gateway into a PayPal Commerce gateway).

Follow the instructions to register the PayPal account on CheckoutChamp. At the end of the registration process, merchantId will be assigned to the gateway.

If the enrollment status is Pending, there will be a button to check the registration status. Press the Check Register Status button to complete the registration.

Use PayPal on Checkout and Upsell Pages

For instructions on using PayPal with a CheckoutChamp checkout page, click here.

For instructions on using PayPal with a Direct API checkout page, click here.

For instructions on using PayPal with PayPal’s SDK, click here.

Note: One-click upsells can only be processed through PayPal if your PayPal account has the Reference Transactions setting enabled inside PayPal. If PayPal will not enable Reference Transactions on your account, you can still process Two-Click upsells by following these instructions:

---

Using the Test Server

You may process using PayPal’s test server

Be sure this is unchecked for live processing.

1. Go to Paypal Developer and login to your PayPal account

2. Go to Sandbox > Accounts and create a Business account

3. Go to CheckoutChamp and create a new PayPal Commerce gateway. Check the useTestServer checkbox. Save.

4. Edit the PayPal Commerce gateway and press the Register button

5. Login to PayPal using the Business account from Step 2

6. Complete the onboarding flow

7. Save the gateway in CheckoutChamp

8. Test transactions as needed

9. It is recommended to use a separate gateway for live transactions. However, if the need arises, do follow these steps to convert the test server gateway to a live account:

   • Edit the gateway in CheckoutChamp

   • Uncheck the useTestServer box

   • Save the gateway

   • Edit the gateway

   • Press the Register button

   • Login and complete the onboarding process using live PayPal account

   • Save the gateway in CheckoutChamp

---

Special Considerations - Phone Number

Obtaining the customer’s phone number may require enabling an option on your PayPal account: