Hosted Fields


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.


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.

Notice of Collectionanchor

PayPal is a data controller and Business for the provision of the payment processing services. In order to satisfy PayPal’s transparency obligations to be known to buyers, you must include the below languages in your own privacy notice, which must be presented to the buyers at or before the point of collection:

We use PayPal for payments and other services. If you wish to use one of these services and pay on our website, PayPal may collect the personal data you provide, such as payment and other identifying information. PayPal uses this information to operate and improve the services it provides to us and others, including for fraud detection, harm and loss prevention, authentication, analytics related to the performance of its services, and to comply with applicable legal requirements. The processing of this information will be subject to PayPal’s privacy policy at

Next Page: Setup and Integration