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.
- 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.
- 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.
- 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:
- 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
- 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
- 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
- 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
Tools