Hosted Fields

Overviewanchor

In order to be eligible for the easiest level of PCI compliance - SAQ A - certain payment fields on the checkout page must be hosted securely. This requires you to host the information on an external payment gateway's domain and present the fields to your users in a frame or with a redirect.

Our Hosted Fields solution accomplishes this by rendering an iframe to handle input of the following payment fields on your checkout page:

  • Card number
  • CVV
  • Expiration date
  • Postal code

This provides you with the ability to customize the look and feel of your web page while ensuring that you are compliant with PCI requirements.

Demoanchor

Here's an example of a configured Hosted Fields integration. Hosted Fields is incredibly flexible and can be styled an infinite number of ways.

See more examples of Hosted Fields integrations.

Hosted Fields is built for merchants who want SAQ A eligibility and control over the styling and layout of their page. If you are looking for a quicker way to start accepting payments and are not concerned with customizability, see our Drop-in integration.

Hosted Fields vs. Drop-inanchor

Here's a general overview of the differences between Hosted Fields and the Drop-in integration.

Hosted Fields Drop-in
  • SAQ A PCI compliant
  • Create your own payment form using your existing styles and layout
  • Customize the behavior and experience of your checkout
  • Use alongside the PayPal Checkout component to accept PayPal
  • Use alongside the Payment Request component to accept cards when the Payment Request API isn't supported
  • SAQ A PCI compliant
  • Fastest way to integrate with Braintree
  • Allows customization of UI with custom CSS
  • Supports 23 languages
  • Includes PayPal button ¹

¹ When enabled in your Control Panel and configured in Drop-in.

Browser supportanchor

Learn more about browser support for v3 of our JavaScript SDK.


Next Page: Setup and Integration →