Integrating the authentication script

⚠️

Warning

We do not offer support for the development and implementation of this SDK.

The 3DS 2.2 authentication protocol is available in a browser-based version, meaning the merchant must include the 3DS script in the checkout page HTML file. The 3DS protocol, when processing the script, allows data exchange between the merchant and the issuer to authenticate the cardholder.

Integrating the authentication protocol script consists of the following steps:

  1. Getting the credentials: get the ClientId and ClientSecret credentials in Cielo website, and use them to create the access_token in the next step.
  2. Creating the access token: the access token must be inserted into the script (JavaScript) and in the HTML in the bpmpi_accesstoken class. See the class mapping tables for more information.
  3. Class mapping: here you should prepare your environment to collect the shopper’s data and execute the script in the shopper’s browser.
  4. Implementing the script: insert the classes in the HTML (body tag) and reference the JavaScript file with the mapped classes.
  5. Implementing the authentication event call: using the data returned in the authentication result, send the transaction for authorization.