Getting Started

Building Blocks

Custom Fields

Subscription Features




Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Fraud Management

Hosted Pages


Reports and Analytics


Open Source Resources

Other Features

API Integration

Third Party Integrations

PayPal via Braintree 


Braintree now accepts payments via PayPal.

Chargebee accepts PayPal via Braintree gateway. You need not maintain two merchants accounts, the Braintree merchant account is sufficient to manage payments via Braintree and PayPal.

With Braintree payment gateway, your customers can now make payments using their PayPal Account. Customers will be prompted to enter their PayPal credentials to complete the payment. Braintree does not charge any processing fees for PayPal transactions.

Braintree's setup guide will give you further instructions on accepting payments via PayPal.

This feature is supported in all countries where Braintree is available.

  • Contact  to enable PayPal as a payment method via Braintree for your Chargebee site.
  • If Multicurrency is enabled in your Chargebee site, kindly ensure that the currencies configured in your Chargebee site are configured in your PayPal Merchant account as well. This is to prevent payment failures in Chargebee when your customer makes the payment with a currency which is not configured in your Chargebee site.
  • For accepting payments via PayPal, you must be using Braintree Direct. For further information on Braintree Direct, contact Braintree's Support Team.
  • The approval process for Braintree to allow payments using PayPal will take 1-2 business days.
  • iframe tags and Chargebee's Rhapsody theme is not supported.

Integrate via Chargebee API 

At checkout, PayPal payment method's token received from Braintree should be passed to Chargebee via API. Refer these APIs for more:

Integrate via Checkout Pages 

Step 1: Enable PayPal in Chargebee

Contact  with your Merchant Account Info to enable PayPal for your Chargebee site. Refer this section for more details.

Step 2: Configure PayPal in Chargebee's hosted pages

You can now proceed to set up PayPal in Chargebee's hosted pages.


Business Description

Provide a Business Description. It serves as an additional note related to the transaction which will show up in your customer's PayPal account. This will enable your customers to easily identify the transactions related to your company.

The business description appears in your PayPal login page as shown below,


You can choose to retrieve the customer's billing address and shipping address from their PayPal account to be auto filled in the checkout pages.

The payment gateway configuration is now complete.

Checkout with PayPal 

Your customers can now see PayPal listed amongst the payment methods in the hosted checkout page.



1. What will happen if I add a new currency to my gateway account?

Contact  to update the Merchant Account Info.

2. What happens when customer cancels the agreement from their PayPal account?

The transactions will fail and show an error. You need to request for an appropriate payment method detail from your customers to manage future payments.

3. How is VAT Location validation performed?

For PayPal via Braintree, customer's payment method country is not provided by the gateway. So, if the IP address for customer is not present, the location status will be marked as invalid and subscription will be canceled on renewal. Read more about Chargebee's Location Validation.