Docs

Log in to read the version of docs relevant to your site, or use the dropdown versions

PayPal Wallet

PayPal Wallet is a digital wallet provided by PayPal that allows users to store and manage payment methods (like credit/debit cards and bank accounts), make purchases, send/receive money, and access other financial services online. With PayPal commerce integration, we will be able to connect the PayPal wallet directly and accept payments via PayPal commerce integration.

Note

If Multicurrency is enabled, please ensure that the currencies configured in your Chargebee site are configured in your PayPal Merchant account as well. Chargebee will mark the invoice as void if the customer makes a payment using a currency that is not configured in your Chargebee site.

Integration Options

Chargebee offers the following options to integrate with PayPal:

Integration MethodDescriptionPCI Requirements

Chargebee Hosted Pages
Note: HPv3 is supported.

In this method, the card information of the customers is collected by Chargebee's checkout and directly passed on to PayPal.

Low
(Your PCI compliance requirements are greatly reduced due to the usage of Chargebee's checkout)

Chargebee JS

Raw card details
You will collect raw card details via your custom checkout and pass them to Chargebee.js 3DS Helper to conduct the 3DS flow. However, this will need you to ensure PCI compliance.

High
(Card information will be collected by you directly; you will have to take care of PCI Compliance requirements)

Chargebee JS (Chargebee Components and Fields)

In this method, Chargebee's components and fields collect customers' card information and tokenise it with PayPal.

Low
(Your PCI compliance requirements are greatly reduced due to the usage of Chargebee's components and fields)

Gateway JS + Chargebee API

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.

Low

Supported Tokens

This integration supports the following tokens in the mentioned format:

TokenDescriptionFormat & Sample
Permanent Token (PayPal JS)Combination of the customer ID and payment method ID at the gateway.

Format: payment_method_id
Sample: 8ck8p8pc

Chargebee Payment Intent ID (Chargebee JS)This is the Payment Intent ID returned after a successful authorization process.

Format:
payment_intent[id]
Sample:
169ofdUnL4xolkH26acRyMoTRN1eBLgH91NgwoiWzIRcuzTg

Configure PayPal wallet

Follow these steps to enable PayPal wallet via PayPal:

  1. Log in to your Chargebee Billing site.
  2. Go to Settings > Configure Chargebee > Payment Gateways.
  3. Click the PayPal instance in which you want to enable the wallet.
  4. The PayPal payment method is enabled by default.

Checkout Flow

When your customer subscribes to a product or service from your website for the first time and chooses to pay using PayPal, a PayPal Billing Agreement is created, which has a Vault ID. Chargebee associates this Vault ID with that customer. This allows Chargebee to charge your customers automatically without them having to perform any action (such as logging into PayPal and approving the transaction) during each renewal. In addition, it can be used to pay one-time charges as well. The Vault ID does not expire unless the customer cancels it.

The checkout flow for your customers is as mentioned below:

  1. After initiating checkout, select PayPal as a mode of payment during checkout.
  2. You are redirected to PayPal, where you enter your PayPal credentials.
  3. You select the payment method and proceed by clicking Continue.
  4. The PayPal agreement/policy page is displayed. Read this and click Agree & Continue.
  5. You are redirected to Chargebee.
  6. Your payment is completed. A subscription is created, and PayPal is added as a payment method.

Was this article helpful?