KYC state changedWebhook

Webhook event notification request.

event_name value: kyc-webhook

This request is sent to registered webhook event handlers after
A user updates their KYC information or their status changes during the KYC review process.

The Request body described below is the message property in the event notification request data. For more information about event notification requests, visit Webhooks.

Securitytilia_auth
Request
Request Body schema: application/json
account_id
string <= 36 characters

The Tilia account ID.

kyc_id
string <= 36 characters

KYC application ID

kyc_requirements
string

Describes an account's KYC requirements.

Possible values are listed in the following table.

Value Description
FULL_KYC The account must go through KYC in order to accrue a stored value balance and receive payouts.
NONE The account does not have additional PII verification requirements.
TAX_UPDATE The account must update their information on file for tax purposes.
Array of objects (KYCMatchCheck)
pii_level
string

Describes the state of PII associated with an account.

Possible values are listed in the following table.

Value Description
BASIC The account's PII exists and can be used for tax purposes, but is not verified.
NONE The account has no associated PII.
FULL The account's PII exists and its KYC state is ACCEPT.
state
string

Identity verification (KYC or KYB) state of this account.

Possible values are listed in the following table.

Value Description
ACCEPT KYC (or KYB) data has been accepted.
CANCEL Tilia's Compliance Team reached out to the user for more info and never received a response. The user can submit a new KYC application.
DENY KYC data has been rejected. New KYC data may be submitted.
MANUAL_REVIEW The account's KYC data is under manual review by the Tilia Compliance Team.
NODATA No information has been collected for the account
NONE Information has been successfully collected for tax purposes, KYC has not been run.
PROCESSING KYC data is being actively processed.
REVERIFY (Legacy) User needs to resubmit a new KYC application.
SYSTEM-CANCELLED Application canceled by the system due to incorrect or incomplete information provided. The user can submit a new KYC application.
Responses
2XX

Return a 2XX status to indicate that the data was received successfully

Request samples
application/json
{
  • "account_id": "acct_2TiDFXHVFMlAuyy7ovvz3YPKv9b",
  • "kyc_id": "kyc_2V2VpXKr8kW6ukYe03VG1QBlnxd",
  • "kyc_requirements": "FULL_KYC",
  • "match_checks": [
    ],
  • "pii_level": "BASIC",
  • "state": "ACCEPT"
}