Create Token

The Create Token process is designed to generate a unique token to be used in the frontend of the iFrame solution in order to identify your site and settings to Veratad.

Create Token

POST https://vx-be.idresponse.com/token/create

This endpoint creates your token with associated settings to access a document iFrame session.

Request Body

Name	Type	Description
user*	string	Your Veratad API username
pass*	string	Your Veratad API Password
journey_id	String	The VX journey ID to be loaded with this token
settings_id	String	The settings profile ID to be loaded with this token
branding_id	String	The branding ID to be loaded with this token

200 Token successfully created.

{
    "result": "Success",
    "message": "Token created successfully",
    "token": "393d50f9-2703-4100-9e4b-dfd8e4fda493",
    "age": "21+",
    "rules": "DCAMS5_0_RuleSet_NAME_DOB",
    "store_on": "FAIL",
    "company_name_for_email": "Company ABC",
    "email_logo_link": "https://yourcompany.com/logo.png",
    "email_logo_height": "50",
    "email_logo_width": "80",
    "dcams_manual_rules": "DCAMS5_0_Manual_Review_RuleSet_NAME_DOB"
}

400 Missing a required input

{
    "result": "Error",
    "message": "Missing a required input",
    "token": ""
}

{
    "result": "Error",
    "message": "Invalid age submitted. Must conform to age+ like 21+",
    "token": ""
}

{
    "result": "Error",
    "message": "Invalid ruleset submitted. Please check the documentation",
    "token": ""
}

{
    "result": "Error",
    "message": "Invalid store_on value. Must be PASS, FAIL or ALL",
    "token": ""
}

401 Username or password is incorrect.

{
    "result": "Error",
    "message": "Either your username or password is incorrect",
    "token": ""
}

IMPORTANT: The token is only good for 6 hours. It is recommended that you generate a new token on each iFrame request.

Request Body

{
    "user": "USERNAME | API KEY",
    "pass": "PASSWORD",
    "journey_id": "SET | DEFAULT", 
    "settings_id": "SET | DEFAULT", 
    "branding_id": "SET | DEFAULT"
}