# PayPal

{% hint style="danger" %}
**Authorization trials (such as Hold Trial Charge, Authorize and Void, etc.) are not supported through PayPal Seamless Checkout**
{% endhint %}

{% hint style="warning" %}
**“Security error: Security header is not valid” means you are using sandbox credentials against the live PayPal endpoint.**
{% endhint %}

{% hint style="info" %}
If you are wanting to integrate PayPal on the WithReach gateway, see [here](https://help.checkoutchamp.com/crm/gateway-setup/gateway-integrations/withreach)
{% endhint %}

{% hint style="info" %}
Before beginning these steps you must [register your PayPal account](https://help.checkoutchamp.com/crm/gateway-setup/gateway-integrations/paypal-commerce-checkout)
{% endhint %}

### Step 1: Login and navigate to the funnel on which to add PayPal <a href="#paypalseamlesscheckout-checkoutchamp-step1-loginandnavigatetothefunnelonwhichtoaddpaypal" id="paypalseamlesscheckout-checkoutchamp-step1-loginandnavigatetothefunnelonwhichtoaddpaypal"></a>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FuidrdF77AguJjgeBrwDP%2Fimage.png?alt=media&#x26;token=1f42cf5e-ca33-449c-8d3f-4f695c4815f3" alt=""><figcaption></figcaption></figure>

***

### Step 2:Click the Settings button on the top left to open the funnel settings <a href="#paypalseamlesscheckout-checkoutchamp-step2-clickthesettingsbuttononthetoplefttoopenthefunnelsettings" id="paypalseamlesscheckout-checkoutchamp-step2-clickthesettingsbuttononthetoplefttoopenthefunnelsettings"></a>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FrB6WpATnQbxLEIvxKZg5%2Fimage.png?alt=media&#x26;token=edeebfd5-a204-4571-a2f6-d5220f8091bc" alt=""><figcaption></figcaption></figure>

***

### Step 3: Open the Payments section <a href="#paypalseamlesscheckout-checkoutchamp-step3-openthepaymentssection" id="paypalseamlesscheckout-checkoutchamp-step3-openthepaymentssection"></a>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2Fij3UNaFk0zw20arjhK5t%2Fimage.png?alt=media&#x26;token=25ea1b77-3361-4e8f-8ce6-407d37a11793" alt=""><figcaption></figcaption></figure>

***

### Step 4: Add a new PayPal gateway or select an existing PayPal gateway <a href="#paypalseamlesscheckout-checkoutchamp-step4-addanewpaypalgatewayorselectanexistingpaypalgateway" id="paypalseamlesscheckout-checkoutchamp-step4-addanewpaypalgatewayorselectanexistingpaypalgateway"></a>

*Note: you can also select a WithReach gateway here. FraudNet, Venmo, and Pay Later are not valid on WithReach.*

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FxBg5SWazmxFcGwubBJ8F%2Fimage.png?alt=media&#x26;token=4522f0b5-a61f-46b6-81ea-7d67742d3c96" alt="" width="563"><figcaption></figcaption></figure>

When checked, the Venmo and Buy Now Pay Later buttons automatically appear alongside the PayPal button.

{% hint style="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.
{% endhint %}

{% hint style="danger" %}
If using PayPal's SDK the page currency will be sent, please make sure you have 'Send To Gateway' enabled for those currencies in the campaign. (Venmo, Pay Later, Fastlane)
{% endhint %}

#### Step 4-1: Adding New PayPal account <a href="#paypalseamlesscheckout-checkoutchamp-step4-1-addingnewpaypalaccount" id="paypalseamlesscheckout-checkoutchamp-step4-1-addingnewpaypalaccount"></a>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FfUfZPCXpuaKdWfDeQYf0%2Fimage.png?alt=media&#x26;token=c0125bb4-66cc-4c75-870c-90707a3992bc" alt=""><figcaption></figcaption></figure>

Enter a **Title** and optionally add **brandName**.<br>

{% hint style="info" %}
**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 ](https://help.checkoutchamp.com/crm/gateway-setup/gateway-integrations/paypal-commerce-checkout#paypalcommercecheckout-testserverusingthetestserver)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** - 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
{% endhint %}

Click “Save & Continue” when you are finished with the PayPal configuration.

***

### Step 5: Save and Continue <a href="#paypalseamlesscheckout-checkoutchamp-step5-saveandcontinue" id="paypalseamlesscheckout-checkoutchamp-step5-saveandcontinue"></a>

{% hint style="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.
{% endhint %}

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FRlELe1QWuyi6mna3Bm8Q%2Fimage.png?alt=media&#x26;token=d4152a1f-3a53-4dbd-9451-72742276bbaf" alt=""><figcaption></figcaption></figure>

***

### Step 6: Edit Checkout page and add PayPal button <a href="#paypalseamlesscheckout-checkoutchamp-step6-editcheckoutpageandaddpaypalbutton" id="paypalseamlesscheckout-checkoutchamp-step6-editcheckoutpageandaddpaypalbutton"></a>

There are 2 PayPal buttons from which to choose. The difference is style only. You can add multiple PayPal buttons to a page.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FoF49AD1pvkoj707O8FgI%2Fimage.png?alt=media&#x26;token=b9b67a84-df0b-4176-a598-9604977a27c5" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FKY07KhBKaeOH7rvhY9Ms%2Fimage.png?alt=media&#x26;token=d6fac68e-aea7-4ee7-83a9-37864f8f6908" alt=""><figcaption></figcaption></figure>

**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.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2Fq0VzaErzGoGCABh3UiWt%2Fimage.png?alt=media&#x26;token=2601d09b-d94c-43b1-92e0-cc88df7d8b7a" alt=""><figcaption></figcaption></figure>

***

### Radio <a href="#paypalseamlesscheckout-checkoutchamp-radio" id="paypalseamlesscheckout-checkoutchamp-radio"></a>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FgIvQUQhcyBWVIlsWi94X%2Fimage.png?alt=media&#x26;token=346288af-1f01-4cc0-86aa-e7edbbba0c55" alt=""><figcaption></figcaption></figure>

**Step 6-1(radio)**: Add a radio button to the page. You may design this to your preference.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F3EraoFX5K5SoJb5ThkqH%2Fimage.png?alt=media&#x26;token=6b3d0471-f307-438b-818a-f029f85694d7" alt=""><figcaption></figcaption></figure>

**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).

{% hint style="warning" %}
Use either all buttons or radios for pay source selection to mitigate any conflicts
{% endhint %}

***

### Step 7: Save the page and exit the page builder <a href="#paypalseamlesscheckout-checkoutchamp-step7-savethepageandexitthepagebuilder" id="paypalseamlesscheckout-checkoutchamp-step7-savethepageandexitthepagebuilder"></a>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FyIo2xWojQPAsfsZmNk7c%2Fimage.png?alt=media&#x26;token=4640bcf6-c9dc-4354-9d06-c39c262da667" alt=""><figcaption></figcaption></figure>

***

### Step 8: On the arrow leaving the checkout page, choose the PayPal button(s) for navigation. <a href="#paypalseamlesscheckout-checkoutchamp-step8-onthearrowleavingthecheckoutpage-choosethepaypalbutton-s" id="paypalseamlesscheckout-checkoutchamp-step8-onthearrowleavingthecheckoutpage-choosethepaypalbutton-s"></a>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FZAeThY5rHJLU6A0PtfEl%2Fimage.png?alt=media&#x26;token=0bf41692-d38d-4dcd-965f-af6b75295b2c" alt=""><figcaption></figcaption></figure>

***

### Step 9: Publish the funnel. You’re done and ready to test! <a href="#paypalseamlesscheckout-checkoutchamp-step9-publishthefunnel.youredoneandreadytotest" id="paypalseamlesscheckout-checkoutchamp-step9-publishthefunnel.youredoneandreadytotest"></a>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FxWsJoie3q6dFudYFkAMQ%2Fimage.png?alt=media&#x26;token=40bf881f-09b1-42e8-92c7-44a4bf7311fb" alt=""><figcaption></figcaption></figure>

***

### Recurring Billing without Reference Transactions enabled <a href="#paypalseamlesscheckout-checkoutchamp-recurringbillingwithoutreferencetransactionsenabled" id="paypalseamlesscheckout-checkoutchamp-recurringbillingwithoutreferencetransactionsenabled"></a>

{% hint style="warning" %}

#### Unfortunately, it is not possible to do recurring billings with PayPal if you cannot enable Reference Transactions on your PayPal account. Contact PayPal to have Reference Transactions enabled. <a href="#paypalseamlesscheckout-checkoutchamp-unfortunately-itisnotpossibletodorecurringbillingswithpaypalify" id="paypalseamlesscheckout-checkoutchamp-unfortunately-itisnotpossibletodorecurringbillingswithpaypalify"></a>

{% endhint %}

***

### Upsells without Reference Transactions enabled <a href="#paypalseamlesscheckout-checkoutchamp-upsellswithoutreferencetransactionsenabled" id="paypalseamlesscheckout-checkoutchamp-upsellswithoutreferencetransactionsenabled"></a>

If Reference Transactions is not enabled on your PayPal account, you can still use PayPal for upsells by redirecting the customer back to PayPal for each upsell.

CheckoutChamp knows if the customer paid with a credit card or PayPal on the initial sale and will process with the same 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” 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.