# JS Button
The ID Check Javascript Button is the easiest way to implement ID Check on your website. The button provides a seamless user experience, takes the user through the ID Check process on their phone and notifies your page when the process is complete.
# Caisson(public_api_key)
Use Caisson(public_api_key)
to initialize the Caisson library. Your public api key is required.
# caisson.button(options)
Create an ID Check button element. It accepts a configuration object. The available options are:
customer_id
(Optional): A string identifying this specific ID Check in your system. The field will be displayed in the dashboard next to each ID Check. This is a free-form string that can be populated with the anything that may help identify ID Checks within your application.appearance
(Optional): A string specifying the background color of the button. Available options are:"light"
and"dark"
. Defaults to"dark"
.
# Return value:
A button DOM element to be mounted on your page.
# button.on(event, handler)
The ID Check button emits several events during the ID Check process. Use the on()
method to register an event handler.
Event | Payload |
---|---|
idCheckCreated | Fired when the ID Check is created after the button is clicked. The handler will receive an idCheck object with the following fields:
check_exchange_token to your server for retrieving ID Check results. See Exchange Check Token for more details. |
idCheckComplete | Fired when your user completes the ID Check flow on their mobile device. The handler receives no payload. |
idCheckProcessing | Occasionally fired when your user completes the Passport ID Check flow on their mobile device, and processing will take a few moments longer than usual. The handler receives no payload. |
error | Fired when an error occurs during the process of creating the ID Check. The payload is an error string describing the error that occurred. |
# button.mount(cssSelector)
The button.mount()
method attaches the ID Check button to the DOM. It accepts a CSS Selector. Here's an example:
<div id="caisson-button"></div>
button.mount("#caisson-button");