Compatibility
Tech Specifications
Overview
The official Braintree Payments extension that allows your Magento 2 store to accept Credit Card payments, PayPal, Apple Pay, and PayPal Credit in one simple integration.
Other Extensions by PayPal
Overview
Back to topBraintree helps businesses of all sizes, from small to large enterprises, accept and process payments to help maximize business opportunities and revenue growth. Companies around the world benefit from the technology and support of Braintree coupled with the scale, backing, and confidence of partnering with a PayPal service.
This is an official Braintree extension built in collaboration with Gene Commerce. This extension updates and extends the core Braintree functionality that comes shipped with Magento 2. This extension takes advantage of the latest version of the Braintree SDK and it is strongly recommended that all Merchants using Braintree upgrade to this extension in order to benefit from many improvements and additional features such as Apple Pay and PayPal Credit.
Local Payment Methods Update
Local Payment Methods have been added in version 4.0.0, allowing merchants to offer 8 new payment methods for EU customers. In order to install version 4, please read the following support article here.
Account & Pricing
A Braintree account is required to use this extension. If you don’t yet have a Braintree account then you will need to sign-up here for one as the extension will not create you an account during the installation. Please also check out the Braintree pricing as fees will apply when using Braintree to process your transactions.
New Features
- Venmo (US only)
- ACH Direct Debit (US only)
- Level 2/3 Processing for all card payments
- 3D Secure 2
- Apple Pay
- PayPal Credit (US and UK)
- Google Pay
- Kount ENS webhook
- M1 to M2 stored card migration tool
- CVV re-verification for stored cards
- Virtual Terminal within the Magento Admin
- PayPal button customization
- PayPal Checkout component that supports PayPal checkout.js v4
Features
- Process credit card, debit card and PayPal transactions from the Magento storefront and Admin Panel.
- Integrated with Apple Pay
- Integrated with Google Pay
- Integrate with PayPal Credit (for US and UK merchants only)
- Secure storage of customer payment details in the PCI-compliant Braintree Vault
- Full support for the latest PCI 3.0 compliant hosted fields solution
- Stored payment detail management – customers can add and delete cards and PayPal accounts from the Magento customer account section
- Supports multi-store, multi-merchant and multi-currency Magento instances
- Provides advanced Braintree fraud protection (AVS and CVV)
- 3D Secure support
- Ability to partially capture transactions
- Ability to configure the capture action either by invoice or by shipment
- Ability to configure the sales action to Authorize only or Authorize and Capture at once for both credit cards and PayPal transactions
- Integration with PayPal through the Braintree Gateway using PayPal's in-context payment solution
- PayPal button customization feature
- PayPal PayeeEmail' and 'DisplayName' configuration at store-level
- PayPal Express integration for cart and checkout pages
- Sandbox testing environment
- Online refunding for both Card and PayPal via the Magento admin
- Customer Services teams can use customer Vaulted information within the Magento admin for MOTO orders
- Virtual Terminal within the Magento Admin
- Integrated with Kount's fraud and risk management solution
Extends The Core M2 Braintree Functionality
- Multi-Site merchants requiring the need to include PayPal's 'DisplayName' configuration can do so on a store-level basis
- Improvements to error messaging
- The transaction source has been included in the sales grid in the Magento admin
- Merchants can now skip the advanced fraud rules to provide flexibility over what transactions get evaluated by Kount
- Authorizations are now voided within Braintree when the Magento order is canceled
- An option to require security code (CVV) when using a saved card is now available on the Front-End
- Braintree custom fields are now available in the front-end however additional custom development is required to map the field names.
NOTE: If you are already a Braintree customer and are using the core Braintree extension, then your account credentials will be preserved when you update to use this extension.
Release Notes
Back to top3.4.1:
- Compatible with Open Source (CE) : 2.2 2.3
- Compatible with Commerce using on prem (EE) : 2.2 2.3
- Compatible with Commerce on Cloud (ECE) : 2.2 2.3
- Stability: Stable Build
-
Description:
Hotfix for issue where stored cards could not be used with CVV Re-verification disabled
3.4.0:
- Compatible with Open Source (CE) : 2.2 2.3
- Compatible with Commerce using on prem (EE) : 2.2 2.3
- Compatible with Commerce on Cloud (ECE) : 2.2 2.3
- Stability: Stable Build
-
Description:
Added
- M1 to M2 Stored Card migration tool
- Kount ENS webhook
- CVV Re-verification for Stored Cards
- Information about Apple Pay on-boarding
- Information about Custom Fields
Fixed
- Level 2/3 Processing data now only used for Credit/Debit card transactions and now includes shipping tax
- Correct state now set on the PayPal Onclick review page
- Bug where PayPal was not using updated shipping address if the customer changed it during checkout
- Bug that stopped Admins creating orders in the backend when Braintree was the only payment method
- API validation check now uses correct Store IDs when a multi-store is being used
Removed
- Removed old PayPal payee email configuration option as it has been deprecated by Braintree
3.3.2:
- Compatible with Open Source (CE) : 2.2 2.3
- Compatible with Commerce using on prem (EE) : 2.2 2.3
- Compatible with Commerce on Cloud (ECE) : 2.2 2.3
- Stability: Stable Build
-
Description:
Fix for Level 2 / 3 Processing shipping data
3.3.1:
- Compatible with Open Source (CE) : 2.2 2.3
- Compatible with Commerce using on prem (EE) : 2.2 2.3
- Compatible with Commerce on Cloud (ECE) : 2.2 2.3
- Stability: Stable Build
-
Description:
Fix for Level 2 / 3 Processing data being sent as the incorrect type.
3.3.0:
- Compatible with Open Source (CE) : 2.2 2.3
- Compatible with Commerce using on prem (EE) : 2.2 2.3
- Compatible with Commerce on Cloud (ECE) : 2.2 2.3
- Stability: Stable Build
-
Description:
New payment methods added - Venmo and ACH Direct Debit
Level 2 / 3 Processing - Level 2 and 3 processing can help you qualify for lower interchange rates on transactions made with certain Visa and Mastercard corporate and purchasing cards
Various bugfixes
3.2.1:
- Compatible with Open Source (CE) : 2.2 2.3
- Compatible with Commerce using on prem (EE) : 2.2 2.3
- Stability: Stable Build
-
Description:
Hotfix for a bug in the admin create order page
3.2.0:
- Compatible with Open Source (CE) : 2.2 2.3
- Compatible with Commerce using on prem (EE) : 2.2 2.3
- Stability: Stable Build
-
Description:
3DS 2 now supported for Credit Card transactions, including stored cards.
3.1.2:
- Compatible with Open Source (CE) : 2.2 2.3
- Compatible with Commerce using on prem (EE) : 2.2 2.3
- Stability: Stable Build
-
Description:
Refactoring
PHP 7 return type hinting in place where applicable
Classes imported with 'use' statements
PHPDocs updated
Various refactoring with returns, logic operators etc
Added
Callback to delete stored card in Braintree when Customer deletes card in account
Fixed
Vaulted cards now work with 3DS
Order button "unstuck" after invalid card details/failed payment
Stop cards always being stored after successful order
No cart session exception handled correctly
PayPal
Credit instalments now sorted on Product page
Billing address now updated correctly
Quote updater no longer throws an error if store uses DB table prefix
Shipping address now used for Virtual Products
Voucher redirect loop fixed
2nd address line now included
Credit calculator now uses correct total values
Apple Pay
Shipping cost is no longer added multiple times
Apple Pay dialog now shows correct total on initial popup
3.1.0:
- Compatible with Open Source (CE) : 2.2 2.3
- Compatible with Commerce using on prem (EE) : 2.2 2.3
- Stability: Stable Build
-
Description:
Allows merchants to enable the Pay with PayPal button directly on the product page.
3.0.6:
- Compatible with Open Source (CE) : 2.2 2.3
- Compatible with Commerce using on prem (EE) : 2.2 2.3
- Stability: Stable Build
-
Description:
- Smart Payment Button Update
- 2.3.0 and 2.2.6 backwards compatibility
- UI Update for the Card form in the checkout
- Improved admin config labels
- Additional class names for ApplePay and PayPal containers for developer extensibility
- Bugfix: Remove Duplicated Report Class
- Bugfix: Improved check for PayPal Credit Sandbox
- Bugfix: Improved Validation for checkout T&Cs
- Bugfix: Correctly disable the Place Order button for card payments
- Bugfix: Enhanced error handling for ApplePay Shipping
- Bugfix: Autofill issue with Google Chrome Browser
- Bugfix: Pass the locale to the PayPal button
3.0.5:
- Compatible with Open Source (CE) : 2.2
- Compatible with Commerce using on prem (EE) : 2.2
- Stability: Stable Build
-
Description:
- Update JS SDK to 3.32.0
- Enable Google Pay for merchants
3.0.4:
- Compatible with Open Source (CE) : 2.2
- Compatible with Commerce using on prem (EE) : 2.2
- Stability: Stable Build
-
Description:
Braintree PHP SDK Version: 3.22.0
Braintree JS SDK Version: 3.19.1
Due to restrictions within the Magento 2.2.0 codebase, GENE are only able to use version 3.22.0 of the PHP SDK. Any future PHP SDK updates will need to be coordinated with Magento.
The module is only compatible with Magento 2.2.0.
PayPal Credit
PayPal Express Checkout
Additional Admin Configuration Options
Improvements to Error Messages
Apple Pay
Virtual Terminal
Custom Fields
Advanced Fraud Rules
Transaction Source
Verify Credentials
Intent Sale
'DisplayName' Parameter
'PayeeEmail' Configuration
3DSecure for vaulted cards and improvements to presentation
Multi-Currency Handling
PayPal Button Customisation