Skip to main content
This is a reference guide for the Hosted Fields SDK. The SDK is a JavaScript file which should be loaded via a script tag on any page where you want to load our hosted fields. Once the script loads the window object will have a window.confidoHostedFields object with the methods documented here. The confidoHostedFields object is a singleton. This means you can only have one instance of hosted fields per window. If you are looking to get started quickly, see the Hosted Fields Quick Start Guide. You can use Hosted Fields when accepting a payment (Payment Session) or saving a payment method for later use (Save Payment Method Session). The main difference between the two are the API calls you will make before you initialize and after the fields have been submitted.

​
Including the script

Include the script on any page you need to load the Hosted Fields. 
<script src="https://js.gravity-legal.com/hosted-fields.js" />

<!-- Or in the Sandbox Environment -->

<script src="https://js.sandbox.gravity-legal.com/hosted-fields.js" />
The script will use window.postMessage to post a message when it has finished loading and is ready for initialization. You can set up a listener to get notified. 
const myListener = (e) => {
  if (e.data === "confido_hosted_fields_script_loaded") {
    console.log("sdk is loaded!");
  }
};

window.addEventListener("message", myListener);