Webhooks

Our identity validation process consists of two steps to verify the user's identity, and it must be completed within 20 minutes.

Once the validation is complete, we will send a webhook notification to your system with the validation results. You can also retrieve detailed validation results using our API.

Setting up the webhook

To ensure the security and integrity of our system, the setup and management of webhooks and tokens are exclusively handled by authorized operators. If you require a webhook or token, please submit a request through the designated channels, and our team will assist you in obtaining the necessary credentials.

Example of Webhook Payload:

{
    "id": "5169bc58-5777-472b-8eb6-8bb660d62812",
    "document": "12345678910",
    "approved": true,
    "status": "APPROVED",
    "merchant_id": "3da83a2e-92f7-4e6c-b799-84cf84b6ab8b"
}

Webhook Status

The values in the status field are related to the comparison between the document photo provided and the selfie. Check the possible return values below:

{
    "APPROVED"
    "REPROVED"
    "EXPIRED"
    "ERROR"
}