Back to Platform Selection

Chargebee

PayPal Upgrade Guide

This document guides you through the process of migrating from legacy to the latest PayPal Checkout solution, including configuring the Checkout flow, Credit & Debit Card processing, and Pay with Venmo.

Requirements & Installation

Prerequisites

Ensure that you have configured the following requirements to accept payments via PayPal Commerce with Chargebee.

  1. Have a PayPal Business Account 
    • A PayPal Business Account is not the same as a PayPal Personal Account. Find more on the types of PayPal accounts here.
  2. Enable Reference Transactions in your PayPal Business Account 
    • It is mandatory that you have reference transactions enabled in your PayPal Business Account. To enable reference transactions in your Chargebee live site, contact PayPal Customer Support. Note that PayPal does not support reference transactions for sandbox accounts.
  3. Configure supported currencies 
    • Ensure that you have configured the same list of currencies in both your PayPal Business Account and your Chargebee live site.


Integration Options

Chargebee offers the following options to integrate with PayPal:

  1. Chargebee Hosted Pages
    • Customer Card Collection: Customer card information is collected by Chargebee checkout and directly passed on to PayPal. HPv3 is supported
    • PCI Requirements: LOW.  Your PCI compliance requirements are greatly reduced due to the usage of Chargebee checkout.
    • Developer Information: LINK
  2. Chargebee JS
    • Customer Card Collection: Raw customer card details are collected via your custom checkout and passed to Chargebee.js 3DS Helper to conduct the 3DS flow.
    • PCI Requirements: HIGH. As card information is collected by you directly, you are required to ensure PCI Compliance requirements
    • Developer Information: LINK
  3. Chargebee JS | Chargebee Components + Fields
    • Customer Card Collection: Chargebee components and fields collect customers' card information and tokenise it with PayPal.
    • PCI Requirements: LOW.  Your PCI compliance requirements are greatly reduced due to the usage of Chargebee components and fields.
    • Developer Information: LINK
  4. Gateway JS + Chargebee API
    • Customer Card Collection: The payment method is collected in the Gateway's JS and converted into a permanent token. This permanent token will be used to process payments associated with the respective customer.
    • PCI Requirements: LOW
    • Developer Information: LINK


Supported Tokens

Token Description Format & Sample
Permanent Token  (PayPal JS) Payment method ID generated at the gateway. Format: payment_method_id  
Sample: 8ck8p8pc
Chargebee Payment Intent ID  (Chargebee JS) Payment Intent ID returned after a successful authorization process. Format: payment_intent[id]  
Sample:
169ofdUnL4xolkH26acRyMoTRN1eBLgH91NgwoiWzIRcuzTgW

Upgrade Walkthrough (Video)

Visual Upgrade Guide

Configure PayPal Checkout

PayPal Checkout is a comprehensive payments solution that enables buyers to purchase goods and services from multiple providers under a single umbrella. Integrating PayPal Checkout with Chargebee allows merchants to accept payments in up to 25 currencies across the globe via card payments.

To configure PayPal Checkout, follow the below steps:
Step 1

Log into your Chargebee Billing site at https://app.chargebee.com/login

Step 2

Go to Settings > Configure Chargebee > Payment Gateways.

Step 3

Click +Add Gateway.

Step 4

Select PayPal.

screenshot-6
Step 5

Connect to an existing account or create a new one.

screenshot-7
Step 6

Connect to your PayPal account using your username and password.

screenshot-8
Step 7

Click Go back to Test Store.

screenshot-9
Step 8

The configuration page appears as shown below. Click "Add" to add a Business description. The description you add here is displayed in the Checkout screen. Note: All transactions made via the Chargebee test site will be available in your PayPal sandbox environment.

screenshot-10
© PayPal 1999–2024