| Warning |
|---|
Authorization trials (such as Hold Trial Charge, Authorize and Void, etc.) are not supported through PayPal Seamless Checkout |
| Note |
|---|
“Security error: Security header is not valid” means you are using sandbox credentials against the live PayPal endpoint. |
We made it very easy for you to connect your PayPal account to your Checkout Champ checkout page. This document provides instructions on how to do so.
| Note |
|---|
PayPal is compatible with Capture on Shipment enabled on the campaign. However PayPal will not work with both physical and digital products on a Capture on Shipment order. Be sure orders are all physical or all digital when using Capture on Shipment. |
| Info |
|---|
This PayPal integration uses Express Checkout. |
| Info |
|---|
If you are wanting to integrate PayPal on the WithReach gateway, see here |
Step 1: Login and navigate to the funnel on which to add PayPal
...
Step 2:Click the
...
Settings button on the top left to open the funnel settings
...
Step 3: Open the Payments section
...
Step 4: Add a new PayPal gateway or select an existing PayPal gateway
...
Note: you can also select a WithReach gateway here. Frauidnet, venmo, and pay later are not valid on WithReach.
...
| Info |
|---|
Note: Using the Venmo and Pay Later options require the use of the Pay Pal button. These options will not display when using the Radio “payment_method” alternative. |
Step 4-1: Adding New PayPal account
...
Enter a Title and optionally add brandName.
| Info |
|---|
referenceTransactionsEnabled secure3DS - Required if using PayPal for upsells and/or recurring billingssendAddressOnUpsell - Checkout Champ will send the address for upsell transactions to PayPalChoose 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 - Checkout Champ will send Send the tracking numbers for orders to PayPal (Must add “clientId” and “secret” to PayPal credentials) skipAddressNonShippable - If there are only digital products on an order then do not require selection of a delivery address at PayPal |
Click “Save & Continue” when you are finished with the PayPal configuration.
...
Step 5: Save and Continue
...
| Info |
|---|
Before saving, consider if you need to use Venmo, Pay Later, or FraudNet. Check the appropriate box as needed. Venmo and Pay Later are supported only when referenceTransactions is disabled OR referenceTransactions and vaultEnabled are both enabled. You cannot choose different payment types for checkout and upsells. For example, if a checkout is done on Venmo then the upsell must also be on Venmo. Rebills are supported on Venmo when referenceTransactions and vaultEnabled are both enabled. Rebills are never supported on Pay Later. |
...
Step 6: Edit Checkout page and add PayPal button
There are 2 PayPal buttons from which to choose. The difference is style only. You can add multiple PayPal buttons to a page.
...
Step 6-1(button): Customize size of button by clicking on the button and dragging the highlighted corners or use Dimensions tab for advanced edits.
...
Radio
...
Step 6-1(radio): Add a radio button to the page. You may design this to your preference.
Step 6-2(radio): Select the radio button and change the settings so the Name is “payment_method”. This may also be used with the payment toggler by setting the name to “fk-payment-option-toggler“. Then set the Value of the radio button to the name of the pay source in all caps (CREDITCARD, PAYPAL, etc).
| Note |
|---|
Use either all buttons or radios for pay source selection to mitigate any conflicts |
...
Step 7: Save the page and exit the page builder
...
Recurring Billing without Reference Transactions enabled
| Note |
|---|
Unfortunately, it is not possible to do recurring billings with PayPal if you cannot enable Reference Transactions on your PayPal account. You will need to reach out to PayPal to have Reference Transactions enabled. |
...
Upsells without Reference Transactions enabled
...
CheckoutChamp knows if the customer paid with a credit card or PayPal on the initial sale and will process with the same paySource payment method on the upsell pages. This means you don’t need to design your upsell pages any differently than they already are. Using your existing “yes” “Yes” button on the upsell pages, a PayPal customer will redirect to PayPal if the PayPal gateway added into CheckoutChamp does not have Reference Transactions enabled.