Docs

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

PayPal via Braintree

Introduction

Braintree accepts payments via PayPal. This means you can connect Braintree with Chargebee and accept payments via Braintree and PayPal. Braintree's setup guide provides further instructions about linking PayPal with Braintree.

With the Braintree payment gateway, your customers can 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. You can view all your payment transactions processed via card and PayPal in the Braintree account.

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

Note:

  • If multicurrency is enabled in your Chargebee site, ensure that the currencies configured in your Chargebee site are also configured in your PayPal merchant account. This prevents payment failures in Chargebee when your customer makes a payment with a currency 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 are not supported.

Integrate via Chargebee API

Step 1: Set up PayPal in Braintree

Click here to learn more about configuring PayPal in Braintree.

Step 2: Process transactions via Chargebee API

At checkout, PayPal payment method's nonce (as a temporary token) received from Braintree should be passed to Chargebee via API. Click here to learn more about temporary tokens and other payment parameters. Refer to these APIs for more:

Integrate via Checkout Pages

Step 1: Set up PayPal in Braintree

Click here to learn more about configuring PayPal in Braintree.

Step 2: Enable PayPal in Chargebee

To enable PayPal for Braintree in your Chargebee site:

  1. Go to Settings > Payment Gateways > Braintree.
  2. Enable PayPal, and specify your Braintree merchant account ID for respective currencies.
  3. Click Proceed.

Step 3: 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 enables 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 among the payment methods in the hosted checkout page.

Note:

Learn more about how to link your PayPal sandbox account to your Braintree test account here.

FAQ

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

Make sure that you have added the new currency in your Chargebee site. You can update the Braintree Merchant Account Info for the newly added currency from Settings > Payment Gateways > Braintree > PayPal.

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

Future payments for that customer will fail and a notification will be sent (to the merchant). You can either cancel the subscription immediately or request the customer to update another payment method.

3. How is VAT location validation performed?

If copying the billing address from the customer's PayPal account is allowed, the customer's PayPal account country and IP address will be validated against the billing address country. If neither is present, the location status will be marked as invalid and the subscription will be canceled on renewal. Read more about Chargebee's location validation.

4. Can I include item-level details in PayPal transactions via Braintree?

Yes, Chargebee supports passing Item ID and Item Name in PayPal transactions processed through Braintree. These item-level details help improve transparency by giving customers clearer insight into what they’re being charged for, which can help reduce chargeback rates linked to vague transaction descriptions. To enable this feature for your site, please contact support@chargebee.com. Once enabled, item-level data will be automatically included in the transaction payload when available and no additional configuration is required on your end.

Yes, Chargebee supports passing Item ID and Item Name in PayPal transactions processed through Braintree. These item-level details help improve transparency by giving customers clearer insight into what they’re being charged for, which can help reduce chargeback rates linked to vague transaction descriptions. To enable this feature for your site, please contact support@chargebee.com. Once enabled, item-level data will be automatically included in the transaction payload when available and no additional configuration is required on your end.

Was this article helpful?