What we do
Tools
Industries
Department
How we workLet's talk →
Home/Braintree
Braintree

The Braintree Gateway Now: Checkout Options, the Vault, and the Money After

Braintree is PayPal's gateway for businesses that want cards, PayPal, Venmo, Apple Pay, Google Pay and ACH through one integration, with saved payment methods kept in its vault. PayPal now sells it as PayPal Enterprise Payments, though the developer docs and SDKs still say Braintree. If you run it today, two things need your attention: the checkout component you built on, and how its deposits reach your books.

Where Braintree stops

It takes the payment, but orders, accounting and support are left to be connected by you.

Stuck on Braintree? Let's solve it →
What changed

Drop-in UI is deprecated. Braintree stopped new features and fixes for the Drop-in SDK on October 1, 2026, and says payments through it keep processing until October 1, 2027. The replacement is its standard JavaScript SDK, with components such as Hosted Fields.

Your saved cards don't move. The vault lives on Braintree's side, so changing the checkout UI leaves stored payment methods and subscriptions where they are.

The name changed, the gateway didn't. On WooCommerce the extension is now called PayPal Enterprise Payments (formerly Braintree).

WooCommerce Settings Payments

Ways to put the Braintree gateway on a checkout

If your checkout is It runs on What to check
A WooCommerce store The PayPal Enterprise Payments extension, with separate credit card and PayPal gateways that share one set of API keys. For WooCommerce Subscriptions, the vault and tokenization have to be switched on for each gateway, or renewals can't charge. Our WooCommerce Subscriptions page covers the renewal side.
A custom checkout built on Drop-in Braintree's prebuilt payment form, which shows cards and wallets in one box. Deprecated. It still processes until October 2027, but nothing gets fixed in the meantime, so plan the move instead of waiting for a browser change to break it.
A custom checkout with your own design Hosted Fields and the other JavaScript SDK components. Card fields sit in iframes Braintree hosts, so card numbers never touch your page. You build the layout, validation messages and wallet buttons yourself. More work up front, and no deprecation clock.
Charges with no shopper on the page: renewals, top-ups, invoices The server SDKs charging a payment method already stored in the vault. Endpoints and the transaction lifecycle are on our Braintree API page. Test everything in the Braintree sandbox first.

Moving a checkout off Drop-in without losing saved cards

  1. 1

    List every page that loads Drop-in

    Checkout is the obvious one. Account pages where customers update a card, and admin tools where staff take a phone payment, are the ones that get missed.

  2. 2

    Keep the same client token logic

    Generating the client token with a customer ID is what lets returning customers see their saved methods. The new components use the same server-side token, so that part of your backend stays.

  3. 3

    Vault wallet payments on the server

    Even on Drop-in, Venmo, Apple Pay and Google Pay weren't saved automatically with a customer-ID token. Create the payment method from the nonce on your server, and check your old code did the same.

    Watch for: if customers can delete saved methods, make sure they can't remove the one an active subscription charges.

  4. 4

    Rebuild wallets and 3D Secure in the sandbox

    Each wallet button and the 3D Secure step are separate components now. Run the full set of test cards and wallets before switching live traffic. If you take Venmo, test it on a phone, since it only appears on supported mobile browsers.

  5. 5

    Switch over and watch decline rates

    Compare approvals by payment method for the first week. A drop on one method usually means a missing field or a wallet that never loaded.

Why Braintree money is hard to trace to orders

The gateway records every transaction. Getting from a bank deposit back to the orders inside it is where finance teams lose days.

Waiting for a card settlement webhook

How you'll know: Your system marks orders paid when a webhook arrives, and card orders never get marked.

Fix: Braintree's webhooks cover disputes, subscription status, disbursements, ACH status and a few others, but not card settlement. Use the disbursement webhook as the trigger, then pull the transactions it covers.

PayPal payments missing from the deposit

How you'll know: The Braintree deposit is short by roughly your PayPal sales.

Fix: Transactions paid with PayPal fund your linked PayPal account, not the Braintree deposit, and Braintree tells you to leave them out when matching batches to deposits. Reconcile them against PayPal separately. Our PayPal and QuickBooks reconciliation page covers that side.

Reconciling from the batch summary

How you'll know: Batch totals never quite equal what reached the bank.

Fix: The Settlement Batch Summary tells you what's in each batch. Braintree's own reconciliation guides point to its disbursement reports for matching money to the bank, because those carry the fees and adjustments.

A webhook handler that does the work first

How you'll know: The same dispute or subscription event shows up again and again.

Fix: Braintree treats a response over 30 seconds as a timeout and retries. Parse the bt_signature and bt_payload with the SDK, store the event, answer straight away, and process it from a queue. Skip any event you've already handled.

Subscription meal kits: the box shipped, the renewal had failed

A meal kit company billing monthly renewals through Braintree.

Before

Braintree knew when a renewal didn't go through. The packing list didn't. Boxes went out to customers whose payment had failed, and nobody followed up until someone happened to notice.

Other customers lapsed without meaning to, because a card had expired and nobody asked for a new one.

After

A failed renewal now starts a retry sequence and, if it keeps failing, flags the account for a person to contact before the next box is packed.

Fewer subscribers lapse by accident, and fewer boxes go out unpaid.

Questions people ask

What is Braintree?

A payment gateway owned by PayPal. One integration accepts cards, PayPal, Venmo, Apple Pay, Google Pay and ACH, and its vault stores payment methods for repeat customers and subscriptions. PayPal now markets it as PayPal Enterprise Payments.

Is Braintree owned by PayPal?

Yes. PayPal bought Braintree in 2013. It runs as PayPal's gateway for merchants that want their own checkout, separate from the PayPal button, and is now sold under the PayPal Enterprise Payments name.

How much does Braintree cost?

Standard pricing is a percentage plus a fixed fee per transaction, with custom pricing for larger merchants and a lower rate for verified charities. Rates change, so take the current figure from Braintree's pricing page rather than a review site.

How do I access the Braintree sandbox?

Sign up for a sandbox account through Braintree's developer site. It's separate from production, with its own API keys and test card numbers. Our Braintree sandbox page covers what to test before go-live.

Is Braintree better than Stripe?

Neither is better across the board. Braintree's edge is PayPal and Venmo in the same integration, and a vault that holds those wallets as well as cards. Stripe has the larger set of add-on products. If you're weighing PayPal's side against Stripe, see Stripe vs PayPal.

How do I contact Braintree support?

Log in to the Braintree Control Panel and use the support options there, or go through the developer site if your question is about the API. What's available depends on your account.

Is the Braintree Drop-in UI being deprecated?

Yes. Braintree deprecated the Drop-in SDK on October 1, 2026, and says it keeps processing payments until October 1, 2027. Move to the Braintree JavaScript SDK components, such as Hosted Fields, before then.

Who can move our Braintree integration or reconcile its payouts?

Both jobs are ones n-frames handles: we rebuild checkouts on the current SDK, and build the reconciliation that matches each Braintree disbursement to its orders and fees. For split payments to sellers, see Braintree Marketplace.

Keep reading

Which Braintree API to Call Braintree's server SDKs or its GraphQL API, how client tokens and nonces work, and the statuses a charge moves through from authorized to settled.Braintree Sandbox Set up a Braintree sandbox: credentials, test card numbers, fake-valid-nonce, amounts that force declines, webhook testing, and what changes in production.Braintree Marketplace Who can still use Braintree Marketplace, how service fees and escrow work, and why a seller's refund comes out of the platform's own bank account.Braintree + Venmo Venmo doesn't have its own merchant API. Here's how Braintree actually handles Venmo payments, and what still needs building once one clears.PayPal Business Account How to open or upgrade to a PayPal business account, what it costs, how it differs from personal, and why your PayPal transfers never match your sales.Stripe vs PayPal Stripe vs PayPal on US list rates, checkout control, subscriptions and buyer trust, a worked $80 order on each, and what changes once you run both.Reconcile PayPal in QuickBooks to the Statement Reconcile PayPal in QuickBooks like a bank account, against PayPal's monthly statement, and find the fee, reversal or opening balance that keeps it off.WooCommerce Subscriptions Subscriptions on WooCommerce: what the paid extension does, how to set up a subscription product, what a failed renewal triggers, and what it leaves to you.Stripe Dispute Got a Stripe dispute? Where to respond, how long you have, what accepting or countering costs, which evidence fits each reason, and how to prevent the next.

Let's talk

Tell us the one thing your team does manually that eats up time. We read every message and reply within a day.