
To integrate Braintree Payments with PayPal, you'll need to follow a few steps. First, you'll need to create a PayPal account and obtain your PayPal API credentials.
Make sure you have a Braintree Payments account set up and have obtained your API credentials as well.
Braintree Payments and PayPal have a partnership that allows for seamless integration, so you can easily connect the two services. This is because PayPal is a supported payment method in the Braintree Payments dashboard.
To get started, navigate to the Braintree Payments dashboard and click on the "Settings" icon, then select "Payment Methods" and finally "PayPal".
Getting Started
To get started with Braintree payments through PayPal, you'll need a PayPal Developer Account and a Braintree Account.
First things first, you'll need to create these accounts if you haven't already.
To proceed, you'll need to have a PayPal Developer Account and a Braintree Account.
Prerequisites
To get started, you'll need to have a few things in place.
You'll need a PayPal Developer Account to move forward.
Next, you'll also need to set up a Braintree Account.
With both of these in hand, you'll be ready to configure your account for use with PayPal (with Braintree).
Here's a quick rundown of what you'll need:
- PayPal Developer Account
- Braintree Account
What Is?
Braintree is a payments gateway platform connecting eCommerce companies to different payment networks to process payments using the web or mobile devices.
Braintree offers a range of payment products, including Braintree Direct for accepting online payments, Braintree Marketplace, and Braintree Extend, providing payments data sharing tools.
You can use Braintree to accept payments through various methods, including PayPal transactions, Venmo in the U.S., credit cards, debit cards, and digital wallets like Apple Pay and Google Pay.
Braintree also enables payments through ACH direct debit if customers prefer paying from their bank account.
Here are some credit cards and debit cards processed through Braintree:
- Visa
- Mastercard
- Discover
- American Express (Amex)
- JCB
- Diners Club
PayPal is a multi-currency digital payments platform for managing and transferring money to business and consumer user accounts. It has 325 million active account users.

PayPal account holders can buy and sell certain cryptocurrencies through PayPal, like Bitcoin and Ethereum, for a fee. Users track and manage the cryptocurrencies in their PayPal account.
PayPal sometimes offers special deals with merchants that can result in PayPal credits. For example, PayPal offered a $10 PayPal credit for buying at least $50 in cryptocurrency when the service was introduced in December 2020.
Check this out: What Is Payment Account
Services and Features
Braintree offers a range of features that make it a robust and versatile payment platform. It supports various payment methods, including major credit and debit cards, digital wallets like PayPal, Apple Pay, and Google Pay, and local payment options.
The payment processing system employs advanced security tools to safeguard sensitive card data and reduce the risk of data breaches. Its complex fraud protection feature helps merchants detect and prevent suspicious transactions and scams.
Braintree can accept over 130 currencies, allowing merchants to process more payments, facilitate transactions for global customers, and reduce currency conversion complexities. Its API is renowned for its ease of integration and developer-friendly documentation, making it an ideal choice for businesses seeking tailored payment solutions.
Here are some of the key features of Braintree:
- Diverse payment methods
- Advanced security
- Recurring billing
- Global reach with multi-currency support
- Developer-friendly API
At a Glance: Features

Braintree is a robust and versatile payment platform that can serve as a one-stop shop for businesses of all sizes. It supports various payment methods, including major credit and debit cards, digital wallets, and local payment options.
The platform employs robust protection tools to safeguard sensitive card data and reduce the risk of data breaches. Its complex fraud protection feature helps merchants detect and prevent suspicious transactions and scams.
Braintree's recurring billing feature is beneficial for subscription-based businesses, allowing merchants to set up recurring payment schedules, manage subscriptions, and handle changes or cancellations without much effort.
The platform accepts over 130 currencies, allowing merchants to process more payments, facilitate transactions for global customers, and reduce currency conversion complexities. This feature is ideal for businesses with international customers.
Here are some key features of the Braintree payment gateway:
Braintree is available in 45 countries and requires a PayPal merchant account and a business bank account to use this payment gateway.
Status Workflows
In the Nexio Dashboard, a pending status displays as "authorized" or "AUTHORIZED". This can be confusing, but it's actually a clear indication that the transaction is waiting to be finalized.
The status of a transaction can be determined by checking the transactionStatus, which can display as 10, meaning "authorized".
Successful sale transactions have different statuses depending on the value of isAuthOnly. If it's false, the transaction has a "Sale" status. If it's true, the transaction has an "Auth only" status.
Here's a breakdown of the statuses for each type of transaction:
Each type of transaction has a unique status, making it easier to track and manage transactions in the Nexio Dashboard.
Account Linking and Migration
To link your PayPal account to Braintree, you'll need to navigate to the Braintree Environment and log in. You'll then need to get the API keys, locate the Merchant ID, and configure the options in the PayPal area.
For another approach, see: How Far Is Braintree from Boston?
To support multiple currencies, you must have a different merchant account ID for each currency. Work with your PayPal account representative to arrange this.
Here are the steps to link your PayPal account to Braintree:
- Navigate to the Braintree Environment and log in.
- Get the API keys and locate the Merchant ID.
- Configure the options in the PayPal area and link one or more PayPal accounts.
Note that if you're migrating from PayPal, you'll need to contact PayPal and request a download of your existing subscription agreement IDs. You'll then need to contact Braintree and provide the downloaded file for importing the tokens.
Link Account
Linking your PayPal account to your Braintree environment is a crucial step in setting up your payment system. You can use integration support to complete this step for the Sandbox environment, but you'll need to do the configuration for your production environment.
To link your PayPal account, start by navigating to the Braintree Environment and logging in. You'll need to get the API keys, which can be found in Settings > API. This is where you'll see all your keys displayed.
Locate the Merchant ID, which is found at the bottom of the Keys page. Make a note of this ID, as you'll need it later. You can also use this ID to add new payment methods to your merchant account.
To configure your PayPal account, navigate to Processing Options and click on the PayPal area. You'll be prompted to log in with your PayPal account credentials. After successfully logging in, the PayPal Accounts page will display, and Braintree will retrieve the necessary clientID, PayPal email, and Client Secret.
To link one or more PayPal accounts, click the +Link New PayPal Account button. You'll need to provide PayPal account details, including URLs for Privacy Policy and Terms and Conditions. If you want to enable PayPal Disputes for this account, select Manage PayPal Disputes in the Braintree Control Panel.
Here are the steps to link a PayPal account in a concise list:
- Navigate to the Braintree Environment and log in.
- Get the API keys in Settings > API.
- Locate the Merchant ID at the bottom of the Keys page.
- Navigate to Processing Options and click on the PayPal area.
- Click the +Link New PayPal Account button and provide PayPal account details.
To support multiple currencies, you'll need to have a different merchant account ID for each currency. Work with your PayPal account representative to arrange this.
Migration

Migration can be a complex process, but don't worry, I've got you covered. If you're looking to migrate your PayPal tokens to Braintree, you'll need to contact PayPal and request a download of your existing subscription agreement IDs.
To do this, you'll need to follow these steps: contact PayPal, request a download of your existing subscription agreement IDs, contact Braintree and provide the downloaded file for importing the tokens, and if migrating the tokens to the Nexio vault, continue with the next set of steps.
If you've already migrated your tokens from PayPal to Braintree and want to migrate them to the Nexio vault, you'll need to contact Braintree and request a download of your existing PayPal (with Braintree) Braintree IDs. This file should include as much information as possible, such as apmToken, customerRef, and email.
The following fields can be included in the file as needed: apmToken, customerRef, email, shopperReference, currencyCode, firstName, lastName, orderNumber, shipToAddressOne, shipToAddressTwo, shipToCity, shipToCountry, shipToPostal, shipToState, billToAddressOne, billToAddressTwo, billToCity, billToCountry, billToPostal, billToState, merchantId, originalRefNumber.

Here are the steps to migrate your tokens from PayPal (with Braintree) to the Nexio vault:
- Contact Braintree.
- Request a download of your existing PayPal (with Braintree) Braintree IDs.
- Contact Integrations Support to let them know that you are ready to migrate your tokens from PayPal (with Braintree). They provide you with information about the next steps to take for sending the file.
Configuration and Setup
To use PayPal with Braintree, you'll need to start by working with integrations to add it to your merchant account. This requires having a login for the PayPal developer site and a Braintree account.
You'll also need to have PayPal accounts ready for your different markets. This ensures you can process payments in various regions.
To get started with configuration, you'll need to obtain your PayPal ClientID through Integrations Support. This is a crucial step before moving forward with the configuration process.
You can follow either the new Nexio webhooks or the legacy webhooks, depending on your specific needs.
Configuration
To configure PayPal (with Braintree) for your merchant account, you'll need to start by getting set up on the PayPal developer site. You'll need a login for this site.
You'll also need to have a Braintree account, as well as PayPal accounts ready for your different markets. This is because PayPal (with Braintree) requires these three things to work.

To get started with the configuration steps, you'll need to work with Integrations Support to get your PayPal ClientID. This is a crucial step that will allow you to move forward with the configuration process.
Once you have your PayPal ClientID, you'll need to decide between two configuration options: new Nexio webhooks or legacy webhooks. This decision will determine the specific steps you'll need to follow next.
Here are the two configuration options in more detail:
- New - The new Nexio webhooks
- Legacy - The legacy webhooks
Checkout Page Flow
The Checkout page flow is a traditional payment method where customers are presented with various payment options on a single page. This flow is used for payment methods like PayPal (with Braintree).
To initiate the Checkout page flow, a customer first adds one or more items to their shopping cart. The order amount and a Checkout button are then displayed on the cart page.
When the customer clicks the Checkout button, they are redirected to a Checkout page with all available payment options. This page also collects the customer's address information to calculate tax and shipping costs.
A unique perspective: Venmo Payment Options
If the customer chooses to pay with PayPal (with Braintree), they will be asked to log in to PayPal and select their payment options. Alternatively, if they select a different payment method, such as card or ACH, the process will continue based on the entered payment options.
Here's a step-by-step breakdown of the Checkout page flow:
- The customer adds one or more items to a shopping cart.
- The customer goes to that cart, the order amount displays, along with a Checkout button.
- Customer address information is collected (or retrieved) and is used to generate tax and shipping costs.
- The customer is redirected to a Checkout page with all available payment options.
- If the customer submits payment for card or ACH, the process continues based on the entered payment options.
- The customer is redirected to a Receipt page.
Required Fields
In most cases, required fields are clearly marked with an asterisk (*) in the form. This indicates that the field is mandatory and must be filled out in order to submit the form.
The type of fields that are typically required can vary depending on the specific form and its purpose. For example, a contact form may require a name and email address, while a registration form may require a username and password.
The "Name" field is often a required field, as it helps to identify the user and personalize their experience. This field is usually a text input field that accepts a single line of text.
A phone number is sometimes required, especially for forms that involve scheduling appointments or making reservations. This field is typically a text input field that accepts a specific format of numbers.
In some cases, a company or organization may require a tax ID number or other identifying information. This field is usually a text input field that accepts a specific format of numbers and letters.
Frequently Asked Questions
What is Braintree with PayPal?
Braintree with PayPal is a global payment processing solution that enables seamless transactions with single-touch payments and global currency acceptance. It offers end-to-end checkout experiences for businesses, simplifying the payment process for customers worldwide.
Is Braintree by PayPal safe?
Braintree by PayPal meets the highest industry standards for data security, ensuring your transactions are protected. As a Level 1 PCI DSS compliant provider, you can trust that your sensitive information is safe
What is a Braintree transaction?
A Braintree transaction is a secure payment transfer from a customer's account to a merchant's account, facilitated through various payment options. This includes credit and debit card processing, as well as digital wallet and bank transfer services.
Sources
- https://docs.nexiopay.com/docs/paypal-with-braintree-integration-guide
- https://tipalti.com/resources/learn/braintree-vs-paypal/
- https://rates.fm/payment-systems/braintree-payments-review-features-pricing-and-alternatives/
- https://staxpayments.com/blog/braintree-payment-gateway/
- https://woocommerce.com/document/woocommerce-gateway-paypal-powered-by-braintree/
Featured Images: pexels.com