PayPal Commerce Checkout
This article will show you how to add your PayPal Seamless Checkout gateway to CheckoutChamp so you can use it across your campaigns.
Add Gateway to CRM
Register or Migrate PayPal Gateway
Use PayPal on Checkout and Upsell Pages
Using the Test Server
Additional Note:
Add Gateway to CRM
Navigate to Gateways → Gateway List, then click the smaller green “+” button to add a new gateway
Choose PayPal Commerce from the Gateway dropdown list
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.
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.
guestCheckout - Will redirect the customer to PayPal’s guest checkout page instead of the PayPal login page
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 if you are 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 that 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 useing PayPal with PayPal’s SDK, click here.
For instructions on using PayPal with a form-code checkout page, 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.
Go to https://developer.paypal.com/home and login to your PayPal account
Go to Sandbox > Accounts and create a Business account
Go to CheckoutChamp and create a new PayPal Commerce gateway. Check the useTestServer checkbox. Save.
Edit the PayPal Commerce gateway and press the Register button
Login to PayPal using the Business account from Step 2
Complete the onboarding flow
Save the gateway in CheckoutChamp
Test transactions as needed
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
Additional Note:
Obtaining the customer’s phone number may require enabling an option on your PayPal account: