As a new major version, the 3.0 release has a new API, requiring integration code changes when upgrading from 2.x. This release offers a more powerful, low-level abstraction, giving you more control over the mechanics of your Braintree integration.
Previous versions of the SDK required a form submission for tokenization. Now we're giving you control of tokenization through a simple API call.
This release introduces input formatting in Hosted Fields, creating a UX-friendly and PCI compliant experience.
Our new modular component structure means you can selectively include payment methods to fit your needs.
One of our main goals in this version of the SDK is to make error messaging much more transparent, giving you a clearer picture of what’s happening in your checkout flows.
This is a major version change for Drop-in and requires integration code changes when upgrading from previous versions.
Previous versions of Drop-in were inside of an iframe and did not support custom styles. New Drop-in is added to a
div on your page and can be styled with custom CSS!
The newest versions of Drop-in now allow customers to delete saved payment methods, and you can enable this functionality with a simple boolean.
In version 2.x, Braintree.js is a single file that contains all the tools for any of our JS client-side integrations. With so many ways to integrate, we know that not every merchant needs every line of Braintree.js. Our new modular architecture allows you to pick and choose exactly which components you need.
Like in previous versions, you can get everything you need from
bower as well as using a direct link in a script tag. See Loading the SDK for details. Alternatively, you can now use
require to pull in components directly. For example:
var hostedFields = require('braintree-web/hosted-fields');
To get started with Drop-in, see our Drop-in integration guide.
At the core of every component is an API client that communicates with our gateway. This means every integration begins with the instantiation of a client with a tokenization key or client token as well as a callback to be called when the client is created.
Hosted Fields is our credit card form offering that keeps merchants eligible for the easiest level of PCI compliance. Instead of using your own inputs, we'll host iframes on your page so you never have to worry about dealing with sensitive payment information.
In v3, we've made Hosted Fields much more customizable. In addition to the styling introduced in v2, we've introduced input formatting. This includes spacing in credit card numbers, automatic insertion of slashes in expiration dates, and restricted input to only applicable characters in all fields.
Another significant change is the movement away from tokenization on form submission. In version 2.x, Hosted Fields was instantiated with a form that, when submitted, prompted tokenization. Now, we're giving you control over when to tokenize through a function call.
In version 3.x, we provide a component to integrate with the PayPal Checkout.js library.
<!-- You'll need a div that will become your PayPal button. --> <div id="paypal-button"></div> <!-- Be sure to include checkout.js on your page. --> <script src="https://www.paypalobjects.com/api/checkout.js" data-version-4 log-level="warn"></script>
To keep things easy, all components can share a single client. This can be done by instantiating several components in your
The v3 SDK simplifies the Advanced Fraud Tools integration by pulling your environment and Kount merchant ID (if applicable) directly from your gateway configuration. As a result, you'll only need to pass
kount: true to the data collector component in your client-side code, instead of having to specify Kount details every time.