Braintree Payments PayPal Integration Guide and Tutorial

Author

Reads 778

Detailed view of PayPal app icon on a smartphone screen highlighting mobile payment technology.
Credit: pexels.com, Detailed view of PayPal app icon on a smartphone screen highlighting mobile payment technology.

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.

Credit: youtube.com, PROCESIO - Getting Started | Introduction & Prerequisites

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.

A mobile phone with OXXO Pay on a laptop used for online shopping.
Credit: pexels.com, A mobile phone with OXXO Pay on a laptop used for online shopping.

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

Smartphone displaying PayPal logo next to laptop with online shopping site open.
Credit: pexels.com, Smartphone displaying PayPal logo next to laptop with online shopping site open.

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

Credit: youtube.com, Custom status & notes for Workflow completions

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?

Credit: youtube.com, Omnichannel payments from PayPal Braintree

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:

  1. Navigate to the Braintree Environment and log in.
  2. Get the API keys and locate the Merchant ID.
  3. 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.

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.

Credit: youtube.com, How do I perform a linked account migration between organizations?

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:

  1. Navigate to the Braintree Environment and log in.
  2. Get the API keys in Settings > API.
  3. Locate the Merchant ID at the bottom of the Keys page.
  4. Navigate to Processing Options and click on the PayPal area.
  5. 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

Person using computer for online payment with credit card.
Credit: pexels.com, Person using computer for online payment with credit card.

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.

A woman makes a secure online payment using a laptop and credit card in a cozy setting.
Credit: pexels.com, A woman makes a secure online payment using a laptop and credit card in a cozy setting.

Here are the steps to migrate your tokens from PayPal (with Braintree) to the Nexio vault:

  1. Contact Braintree.
  2. Request a download of your existing PayPal (with Braintree) Braintree IDs.
  3. 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.

A laptop displaying an online checkout form, highlighting technology and e-commerce.
Credit: pexels.com, A laptop displaying an online checkout form, highlighting technology and e-commerce.

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

Credit: youtube.com, New ReConvert's Flow Builder Introduction: Shopify Checkout Page Optimization & Customization

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:

  1. The customer adds one or more items to a shopping cart.
  2. The customer goes to that cart, the order amount displays, along with a Checkout button.
  3. Customer address information is collected (or retrieved) and is used to generate tax and shipping costs.
  4. The customer is redirected to a Checkout page with all available payment options.
  5. If the customer submits payment for card or ACH, the process continues based on the entered payment options.
  6. 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.

Credit: youtube.com, PRG 310 - Visual Studio 2010 - Configure a Required Field Validator

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.

Mike Kiehn

Senior Writer

Mike Kiehn is a seasoned writer with a passion for creating informative and engaging content. With a keen interest in the financial sector, Mike has established himself as a knowledgeable authority on Real Estate Investment Trusts (REITs), particularly in the UK market. Mike's expertise extends to providing in-depth analysis and insights on REITs, helping readers make informed decisions in the world of real estate investment.

Love What You Read? Stay Updated!

Join our community for insights, tips, and more.