Skip to main content

Performing Verifications

A verification can be performed using the following steps:

1. Create a transaction​

To initiate a new verification, first a transaction needs to be created. A transaction represents a candidate. Transaction can be initiated using the Create Transaction API with following inputs.

Request​

{
  "formId": "Verification form Id",
  "webhook": {
    "url": "https://test.io/hook"
  }
}

formId - Contact Trential Support to receive a form id.

webhook - The webhook URL to receive the status of the verification. The webhook will be called with the status of the verification. Once verificaiton is compeleted, report can be fetched using the Get Report API.

Response​

{
  "code": 0,
  "message": "Success",
  "data": {
    "result": {
      "txId": "67fe839ee7f1d31fb1013251"
    }
  }
}

2. Initiate a verification​

To initiate a verification for a transaction, use the Add Verification API For a single transaction, multiple verifications can be initiated for that candidate. More details can be found in individual verifications listed in the next section.

3. Check the status of a verification​

The status of the verification can be received on the webhook.

Webhook Structure​

{  
  "transactionId": "transactionId",  
  "verificationId": "664758e-c4c1572fac-afdafa0",  
  "newState": "newState"
}

4. Get the report​

To get the report of a verification, use the Get Report API by using the transactionId. More details can be found in individual verifications listed in the next section.