How to create a Web Integration Token

After creating a Web Flow, you will need a Web Integration Token to link the Flow with an URL and perform the necessary validations. Follow these steps to create a Web Integration Token in Postman or any other API client.

In order to ease the process, you can see this Postman collection:

  1. Create a POST request with the next URL: You can also refer to our API Reference.

  2. Add the next headers

    • Truora-API-Key: <truora api key> Get an Truora API key
    • Content-Type: application/x-www-form-urlencoded
  3. Add the following params in the request body with their respective values

    • key_name: api-key user name
    • key_type: web
    • grant: digital-identity
    • api_key_version: 1
    • country: The country where the validation is to be performed. Allowed: ALL.
    • redirect_url: URL where the user is to be redirected once the validation is completed
    • flow_id: from flow creation
    • account_id: account ID linked with this validation. Use this ID to trace the validations performed by the account later on. Note that only Account IDs following the regex pattern [a-zA-Z0-9_.-]+ are supported. Please go to Create an Account ID to learn more about it.
    • phone (optional): The user phone number can be set if you already have it. The format is + country_code phone_number e.g.: +573101234567

Note: If you wish to include additional information in the identity validation process, you can do so by registering the inputs using the following structure start_variables.metadata., followed by the variable name and its corresponding result. Example: = juan.

  1. Send the request and copy the api_key from the response.
Response 200
  1. As last step use<api_key> and set the api_key to perform the validation process and sharing the link.
sample image

Note: The Web Integration Tokens have a 2 hours shelf life by default

  1. The process_id is a unique identifier assigned to each <api key> created in Truora, and it appears at the end of the URL when the flow is started. It is important to keep track of this process_id, as it is required to check the status of the process in the endpoint shown in the next step. Additionally, the API key can be verified on the website to obtain information about the process.
  1. The current state of the fetch process is to create a GET request using the following URL. You can also refer to our API Reference.{{process_id}}/result

Response 200

The process_status can either be success or failure at the end. In the meantime, it will be pending. Success occurs when the document validation was successfully. Failure can occur due to an internal error, a time out, or if the document validation is declined.

Note Whenever a validation fails due to inconsistencies in the validation process,a declined reason to indicate the specific reason for the failure Here’s a list of declined reasons.