Docs

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

PayPal Commerce

The PayPal Commerce platform (formerly known as PayPal for Partners) is a comprehensive payments solution that enables buyers to purchase goods and services from multiple providers under a single umbrella. Integrating PayPal Commerce with Chargebee allows merchants to accept payments in up to 25 currencies across the globe via card payments.

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.

Prerequisites

Ensure that you have configured the following requirements in order to for accepting 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.

Supported payment methods

This integration supports the following payment methods:

Integration Options

Chargebee offers the following options to integrate with PayPal:

Integration MethodDescriptionPCI Requirements

Chargebee Hosted Pages
Note: HPv3 is supported.

In this method, customers' card information 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

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

Configuring PayPal Commerce

To configure PayPal Commerce follow the below steps:

  1. Log in to your Chargebee Billing site.
  2. Go to Settings** > Configure Chargebee > Payment Gateways.
  3. Click +Add Gateway.
  4. Select PayPal.
  5. Connect to an existing account or create a new one.
  6. Connect to your PayPal account using your username and password.
  7. Click Go back to Test Store.
  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.

Configuring Cards (Advanced Credit and Debit Card - ACDC)

Follow the steps below to configure the settings for cards:

  1. On the Configure PayPal page, click Manage under Cards.
  2. Enable the following:
    • Always retain card information in Checkout.com when customer updates it: Enabling this option stores the updated card information in PayPal rather than the default gateway.
    • Enable 3D Secure: When enabled, Payments made via card (Debit or Credit) will be authenticated using 3D Secure, if applicable.

Supported Tokens

This integration supports the following tokens in the mentioned format:

TokenDescriptionFormat & Sample
Permanent Token (PayPal JS)Payment method ID generated 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 - 169ofdUnL4xolkH26acRyMoTRN1eBLgH91NgwoiWzIRcuzTgW

Checkout flow

When a customer subscribes to a product or service from your website for the first time and chooses to pay using PayPal, a PayPal Vault ID is created, and Chargebee associates this Vault ID with that customer. The Vault ID 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 ACDC (cards via PayPal) is as mentioned below.

  1. To initiate a purchase, click Proceed to Checkout from the Your Order page.
  2. Enter your Account Details, such as your First Name, Last Name, and Email Address, and click Next.
  3. Enter the Billing Address details and click Next.
  4. Add your card details and click Next.
  5. Complete the 3DS authentication when redirected to the bank page.
  6. Upon successful authentication, customers are redirected to the checkout to confirm the subscription purchase.
  7. Check the order information and click on Pay & subscribe.

Was this article helpful?