Skip to content

Webhook Integration

A message is sent to the webhook endpoint every time a verification session is reviewed on the platform.

The following actions trigger a webhook call:

  • Accepting a new user
  • Rejecting the new user
  • Reopening a closed case
  • Updating the user's information

Accept User

This happens when a compliance analyst checks the user's provided proofs, screening result, and risk assessment, and confirms that he is allowed to fully use the platform.

The data of the JWT has the following information:

{
  "version": "v1",
  "ctx": "kyc",
  "ref": "session-reference",
  "action": "ACCEPT",
  "comment": "optional comment"
}

Reject User

This happens when a compliance analyst judges that the new user is not allowed to use the platform.

The data of the JWT has the following information:

{
  "version": "v1",
  "ctx": "kyc",
  "ref": "session-reference",
  "action": "REJECT", 
  "comment": "optional comment"
}

Reopen Case

A previously closed case can be reopened for further analysis. This triggers the following message:

{
  "version": "v1",
  "ctx": "kyc",
  "ref": "session-reference",
  "action": "REOPEN",
  "comment": "optional comment"
}

Update User's Information

Before accepting a user, the compliance analyst can adjust the user's provided information based on the documentation received. This triggers the following message:

{
  "version": "v1",
  "ctx": "kyc",
  "ref": "session-reference",
  "action": "UPDATE_USER_INFO",
  "comment": "User info updated",
  "details": {
    "address": "",
    "date_of_birth": "2024-05-13",
    "document_number": "123456789",
    "expiration_date": "2024-05-13",
    "first_name": "FirstName",
    "issuing_date": "2024-05-13",
    "last_name": "LastName",
    "occupation": "Accountant"
  },
}