Vendor pluginLast verified 2026-09-11 · Reviewed by a person 2026-09-24
Braintree connects to Adobe Commerce and Magento Open Source out of the box: since 2.4.0 the PayPal Braintree extension (paypal/module-braintree-core) ships inside every release as a vendor-bundled extension, so there is nothing to install. PayPal owns it and Gene Commerce builds it; Adobe bundles and supports it, and its version tracks the Adobe release (4.8.0 with 2.4.9).1
UAT-Ops testing: Braintree's sandbox was tested by UAT-Ops on 2026-09-11 with the directory's card flow (7 passed, 1 expected rejection) → evidence on the Braintree hub. The Adobe Commerce (Magento 2) integration itself has not been run.
Sources checked: 29 claims from 6 sites, listed at the foot of the page.
Connects through Vendor-bundled extension (paypal/module-braintree-core, namespace PayPal_Braintree) included in every 2.4.x release; configured under Stores > Configuration > Sales > Payment Methods > Braintree. Biggest gotcha: Three names on one module.
How it connects
Method
Vendor-bundled extension (paypal/module-braintree-core, namespace PayPal_Braintree) included in every 2.4.x release; configured under Stores > Configuration > Sales > Payment Methods > Braintree1
Maintained by
PayPal (Braintree) with Gene Commerce as developer; bundled and supported by Adobe through the Vendor Bundled Extensions program2
SAQ A for most merchants: card data is entered in the gateway's own fields or page, so it never touches your server. The gateway or your acquirer can still require a different questionnaire.2
What works on this platform
Yes: a source confirms it on this integration. Not verified here: the gateway supports it, but no source confirms this integration exposes it. No: not available. A capability with no source either way is left off.
SEPA/ELV Direct Debit is listed under Local Payment Methods, alongside Bancontact, EPS, iDeal, MyBank and P24 (BLIK from 2.4.9). Not every Braintree local method is exposed; Sofort and giropay were removed in 2.4.8.
3D Secure can be forced on every transaction or gated by a threshold amount; 2.4.7 added frictionless flows and 3DS for non-tokenized Google Pay cards; 2.4.9 updates CSP for the newer Cardinal integration.
Separate vault switches for cards, PayPal, Apple Pay, Google Pay, Venmo and ACH; 2.4.9 adds Real Time Account Updater for vaulted Visa, Mastercard and Discover cards.
Partial invoicing (capture) is documented by the module's support site; on 2.4.0 and 2.4.1 a second partial invoice on a Venmo order failed with a vault_capture error and had to be captured in full.
Set a different Braintree Merchant Account ID per website; the Magento base currency must match the merchant account's currency or Braintree rejects the payment.
Braintree supports this; no source confirms it on this integration.
Capability status reflects the integration and documentation available at the time of verification, not necessarily every capability of the underlying gateway or platform.
Testing it
Create a Braintree sandbox account and take its Merchant ID, Public Key and Private Key from the sandbox Control Panel; in Stores > Configuration > Sales > Payment Methods > Braintree set Environment to Sandbox and enter them (production credentials are a separate set). Pay with Braintree's sandbox cards (Visa 4111111111111111, Mastercard 5555555555554444, Amex 378282246310005, Discover 6011000991300009) and drive outcomes with the amount: 0.01-1999.99 settles, 2000.00-2999.99 is processor declined, 3000.00-3000.99 fails. For webhooks set Enable Webhook to Yes, copy the Fraud Protection URL and add it as a webhook destination in the Braintree Control Panel (API > Webhooks; the role needs Manage Webhooks). Braintree only accepts a public HTTPS URL, so a local store needs a tunnel or a staging host; use Check URL to fire a test notification. Assert that orders move to the configured fraud-approved and fraud-rejected statuses, that ACH orders settle via the webhook, and that 3DS challenge and frictionless paths work with Braintree's 3DS test nonces.1
UAT-Ops runs integration flows like this against the real sandbox and keeps the evidence. Get one email when it opens.
Gotchas
Three names on one module
Adobe ships it, PayPal owns it, Gene Commerce writes it. The Composer package is paypal/module-braintree-core under the PayPal_Braintree namespace, and the standalone Marketplace listing is gone. If a store came up from 2.3 with paypal/module-braintree or gene/module-braintree installed, remove that package before upgrading and repoint customizations at PayPal_Braintree; Adobe's developer guide still uses the removed 2.3 module as its code sample, so do not copy from it.
The module version rides the Adobe release, and patches can roll it back
You do not pick a Braintree version; the Adobe release does: 4.5.0 with 2.4.6, 4.6.1 with 2.4.7, 4.7.0 with 2.4.8, 4.8.0 with 2.4.9. A reported 2.4.8 to 2.4.8-p1 update downgraded the core module from 4.7.0 to 4.6.1-p5. Diff composer.lock after every security patch and expect features such as Google Pay vaulting to exist only on the release that introduced them.
Expired SDK certificates stop payments on old releases
Braintree's SDK certificates expired on 30 March 2026. Adobe patched 2.4.4 and later on 8 April 2025; 2.4.0 to 2.4.3 depend on a Gene patch, and pre-2.4 stores on Gene's own module need 4.0.10. An unpatched store does not degrade, it stops taking cards. If you inherit an older Magento, check this before anything else.
ACH settlement, disputes, local payment method results and fraud decisions all arrive by webhook, and none of it works until you set Enable Webhook to Yes, copy the Fraud Protection URL and register it in the Braintree Control Panel under API > Webhooks. The URL must be public HTTPS, so local stores need a tunnel, and the Control Panel user needs the Manage Webhooks permission. Ignore any Kount fields: the module dropped Kount at 2.4.5.
Currency is decided by the merchant account, not the storefront
Each Braintree merchant account settles in one currency. For a multi-currency site set a different Merchant Account ID at website scope and keep each website's base currency equal to that account's currency, otherwise Braintree rejects the payment. The only alternative is displaying other currencies while charging the base one. PayPal through Braintree adds a second check: enable every currency in the PayPal account or the transaction errors.
Version-specific breakages worth knowing before you inherit a store
Adobe's knowledge base and Gene's patch list record several: on 2.4.5 admins could not create or reorder with Braintree enabled until patch BUNDLE-3137; on 2.4.6 through 2.4.6-p7 PayPal-through-Braintree checkout needed a Gene patch; on 2.4.0 and 2.4.1 a second partial invoice on a Venmo order failed and multi-address checkout hid Braintree entirely. Verify the patch state before re-testing a symptom someone already solved.
Last verified 2026-09-11 · Reviewed by a person 2026-09-24
Integration capabilities, requirements, pricing, availability, and vendor policies may change over time. UAT-Ops documents information based on the authoritative sources and testing available at the time of review.
Where newer information, testing, or vendor documentation materially changes a published claim, UAT-Ops may revise the page to reflect the most current verified information. Readers should confirm time-sensitive requirements with the relevant vendor before making production or purchasing decisions.