This section lists a collection of webhooks that you may receive during transaction monitoring.

Webhook	Description
applicantKytTxnApproved	Transaction was approved and the transfer or deposition of assets/properties can be expected soon.
applicantKytTxnRejected	Checks have been completed and the review result is — rejected.
applicantKytTxnReviewed	Ttransaction that was previously put on hold was reviewed by the officer and removed from the on-hold queue. You can soon expect the webhook to note you on the review results.
applicantKytTxnDeleted	Transaction and all the related information were deleted.
applicantKytOnHold	Based on the rules you applied, the transaction was put on hold and queued for manual review by the dedicated expert. As soon as the transaction is reviewed, its status will be set to applicant reviewed.
applicantKytTxnAwaitingUser	Transaction status was set to awaiting user. This means that the rule requiring the applicant action, such as passing an additional check, was triggered. The scoring is stopped until the applicant completes the required flow.
applicantKytTxnDataChanged	Transaction data was enriched by the service. This means that the wallet ownership was confirmed, and the transaction information is unmasked.

📘
Note
Personal applicant information is not available in the webhook payload. To get this information, use this API method.

👍
Tip
If you are not receiving webhooks, try to check your endpoints using SSL Labs or Docker.

applicantKytTxnApproved

{
  "applicantId": "634829375766b80001a40152",
  "applicantType": "individual",
  "correlationId": "f24f6616020245053139a6537303a251",
  "sandboxMode": false,
  "externalUserId": "customExternalUserId",
  "type": "applicantKytTxnApproved",
  "reviewResult": {
    "reviewAnswer": "GREEN"
  },
  "reviewStatus": "completed",
  "createdAt": "2024-04-24 11:15:09+0000",
  "createdAtMs": "2024-04-24 11:15:09.446",
  "clientId": "coolClientId",
  "kytTxnId": "64a7dc05fbf57c624afcb72d",
  "kytDataTxnId": "uauu08x44xexbohyh4lkp9",
  "kytTxnType": "finance"
}

Field	Type	Description
`applicantId`	String	Unique identifier of the applicant in the Sumsub system.
`applicantType`	String	Defines the applicant entity type: `individual` — for applicants registered and checked as individuals. `company` — for applicants registered and checked as legal entities.
`correlationId`	String	Unique identifier of the event.
`sandboxMode`	Boolean	Set to `true` if the webhook was sent from Sandbox.
`externalUserId`	String	Unique applicant identifier as registered on your side. When creating an applicant, you can generate and add the `externalUserId` manually, or it will be automatically generated and added to the applicant profile by Sumsub.
`type`	String	Webhook type. In this context, it is `applicantKytTxnApproved`.
`reviewResult`	Object	Contains extra information on the transaction verification results.
`reviewStatus`	String	Indicates the current transaction status (`init`, `onHold`, `completed`).
`createdAt`	Date	Date and time when the webhook was created (format `yyyy-MM-dd HH:mm:ss+0000`, e.g. `2021-05-14 16:00:25+0000`) in UTC.
`createdAtMs`	Date	Date and time when the webhook was created, considering milliseconds (format `yyyy-MM-dd HH:mm:ss.fff`, e.g. `2021-05-14 16:00:25.032`) in UTC.
`clientId`	String	Unique identifier of you as our client in the Sumsub system. This identifier is assigned to you when you are registered in and get access to the Sumsub system. It usually resembles your name or your company name. `clientId` is automatically added to the applicant profile when it is created.
`kytTxnId`	String	Unique transaction identifier (`.id`) on the Sumsub side.
`kytDataTxnId`	String	Unique transaction identifier (`data.txnId`) on your side.
`kytTxnType`	String	Transaction type. Expects values: `finance`(default) `kyc` `travelRule` `userPlatformEvent` `login` `signup` `passwordChange` `twoFaReset`

applicantKytTxnRejected

{
  "applicantId": "634829375766b80001a40152",
  "applicantType": "individual",
  "correlationId": "0f5a7c828bab750775564534fc0470a8",
  "sandboxMode": false,
  "externalUserId": "customExternalUserId",
  "type": "applicantKytTxnRejected",
  "reviewResult": {
    "reviewAnswer": "RED",
    "reviewRejectType": "FINAL"
  },
  "reviewStatus": "completed",
  "createdAt": "2024-04-24 11:15:09+0000",
  "createdAtMs": "2024-04-24 11:15:09.446",
  "clientId": "coolClientId",
  "kytTxnId": "64a7dc05fbf57c624afcb72d",
  "kytDataTxnId": "j8bqz29yn491vksi9qfydw",
  "kytTxnType": "finance"
}

Field	Type	Description
`applicantId`	String	Unique identifier of the applicant in the Sumsub system.
`applicantType`	String	Defines the applicant entity type: `individual` — for applicants registered and checked as individuals. `company` — for applicants registered and checked as legal entities.
`correlationId`	String	Unique identifier of the event.
`sandboxMode`	Boolean	Set to `true` if the webhook was sent from Sandbox.
`externalUserId`	String	Unique applicant identifier as registered on your side. When creating an applicant, you can generate and add the `externalUserId` manually, or it will be automatically generated and added to the applicant profile by Sumsub.
`type`	String	Webhook type. In this context, it is `applicantKytTxnRejected`.
`reviewResult`	Object	Contains extra information on the transaction verification results.
`reviewStatus`	String	Indicates the current transaction status (`init`, `onHold`, `completed`).
`createdAt`	Date	Date and time when the webhook was created (format `yyyy-MM-dd HH:mm:ss+0000`, e.g. `2021-05-14 16:00:25+0000`) in UTC.
`createdAtMs`	Date	Date and time when the webhook was created, considering milliseconds (format `yyyy-MM-dd HH:mm:ss.fff`, e.g. `2021-05-14 16:00:25.032`) in UTC.
`clientId`	String	Unique identifier of you as our client in the Sumsub system. This identifier is assigned to you when you are registered in and get access to the Sumsub system. It usually resembles your name or your company name. `clientId` is automatically added to the applicant profile when it is created.
`kytTxnId`	String	Unique transaction identifier (`.id`) on the Sumsub side.
`kytDataTxnId`	String	Unique transaction identifier (`data.txnId`) on your side.
`kytTxnType`	String	Transaction type. Expects values: `finance`(default) `kyc` `travelRule` `userPlatformEvent` `login` `signup` `passwordChange` `twoFaReset`

applicantKytTxnReviewed

{
  "applicantId": "634829375766b80001a40152",
  "applicantType": "individual",
  "correlationId": "0f5a7c828bab750775564534fc0470a8",
  "sandboxMode": false,
  "externalUserId": "customExternalUserId",
  "type": "applicantKytTxnReviewed",
  "reviewResult": {
    "reviewAnswer": "RED",
    "reviewRejectType": "FINAL"
  },
  "reviewStatus": "completed",
  "createdAt": "2024-04-24 11:15:09+0000",
  "createdAtMs": "2024-04-24 11:15:09.446",
  "clientId": "coolClientId",
  "kytTxnId": "64a7dc05fbf57c624afcb72d",
  "kytDataTxnId": "j8bqz29yn491vksi9qfydw",
  "kytTxnType": "finance"
}

Field	Type	Description
`applicantId`	String	Unique identifier of the applicant in the Sumsub system.
`applicantType`	String	Defines the applicant entity type: `individual` — for applicants registered and checked as individuals. `company` — for applicants registered and checked as legal entities.
`correlationId`	String	Unique identifier of the event.
`sandboxMode`	Boolean	Set to `true` if the webhook was sent from Sandbox.
`externalUserId`	String	Unique applicant identifier as registered on your side. When creating an applicant, you can generate and add the `externalUserId` manually, or it will be automatically generated and added to the applicant profile by Sumsub.
`type`	String	Webhook type. In this context, it is `applicantKytTxnReviewed`.
`reviewResult`	Object	Contains extra information on the transaction verification results.
`reviewStatus`	String	Indicates the current transaction status (`init`, `onHold`, `completed`).
`createdAt`	Date	Date and time when the webhook was created (format `yyyy-MM-dd HH:mm:ss+0000`, e.g. `2021-05-14 16:00:25+0000`) in UTC.
`createdAtMs`	Date	Date and time when the webhook was created, considering milliseconds (format `yyyy-MM-dd HH:mm:ss.fff`, e.g. `2021-05-14 16:00:25.032`) in UTC.
`clientId`	String	Unique identifier of you as our client in the Sumsub system. This identifier is assigned to you when you are registered in and get access to the Sumsub system. It usually resembles your name or your company name. `clientId` is automatically added to the applicant profile when it is created.
`kytTxnId`	String	Unique transaction identifier (`.id`) on the Sumsub side.
`kytDataTxnId`	String	Unique transaction identifier (`data.txnId`) on your side.
`kytTxnType`	String	Transaction type. Expects values: `finance`(default) `kyc` `travelRule` `userPlatformEvent` `login` `signup` `passwordChange` `twoFaReset`

applicantKytTxnDeleted

{
  "applicantId": "634829375766b80001a40152",
  "applicantType": "individual",
  "correlationId": "0f5a7c828bab750775564534fc0470a8",
  "sandboxMode": false,
  "externalUserId": "customExternalUserId",
  "type": "applicantKytTxnDeleted",
  "reviewStatus": "completed",
  "createdAt": "2024-04-24 11:15:09+0000",
  "createdAtMs": "2024-04-24 11:15:09.446",
  "clientId": "coolClientId",
  "kytTxnId": "64a7dc05fbf57c624afcb72d",
  "kytDataTxnId": "j8bqz29yn491vksi9qfydw",
  "kytTxnType": "finance"
}

Field	Type	Description
`applicantId`	String	Unique identifier of the applicant in the Sumsub system.
`applicantType`	String	Defines the applicant entity type: `individual` — for applicants registered and checked as individuals. `company` — for applicants registered and checked as legal entities.
`correlationId`	String	Unique identifier of the event.
`sandboxMode`	Boolean	Set to `true` if the webhook was sent from Sandbox.
`externalUserId`	String	Unique applicant identifier as registered on your side. When creating an applicant, you can generate and add the `externalUserId` manually, or it will be automatically generated and added to the applicant profile by Sumsub.
`type`	String	Webhook type. In this context, it is `applicantKytTxnDeleted`.
`reviewStatus`	String	Indicates the current transaction status (`init`, `onHold`, `completed`).
`createdAt`	Date	Date and time when the webhook was created (format `yyyy-MM-dd HH:mm:ss+0000`, e.g. `2021-05-14 16:00:25+0000`) in UTC.
`createdAtMs`	Date	Date and time when the webhook was created, considering milliseconds (format `yyyy-MM-dd HH:mm:ss.fff`, e.g. `2021-05-14 16:00:25.032`) in UTC.
`clientId`	String	Unique identifier of you as our client in the Sumsub system. This identifier is assigned to you when you are registered in and get access to the Sumsub system. It usually resembles your name or your company name. `clientId` is automatically added to the applicant profile when it is created.
`kytTxnId`	String	Unique transaction identifier (`.id`) on the Sumsub side.
`kytDataTxnId`	String	Unique transaction identifier (`data.txnId`) on your side.
`kytTxnType`	String	Transaction type. Expects values: `finance`(default) `kyc` `travelRule` `userPlatformEvent` `login` `signup` `passwordChange` `twoFaReset`

applicantKytOnHold

{
  "applicantId": "634829375766b80001a40152",
  "applicantType": "individual",
  "correlationId": "98d4dac61c977c1b3f81d6ab78d29c3c",
  "sandboxMode": false,
  "externalUserId": "customExternalUserId",
  "type": "applicantKytOnHold",
  "reviewStatus": "onHold",
  "createdAt": "2024-04-24 11:15:09+0000",
  "createdAtMs": "2024-04-24 11:15:09.446",
  "clientId": "coolClientId",
  "kytTxnId": "64a7dc05fbf57c624afcb72d",
  "kytDataTxnId": "j8bqz29yn491vksi9qfydw",
  "kytTxnType": "finance"
}

Field	Type	Description
`applicantId`	String	Unique identifier of the applicant in the Sumsub system.
`applicantType`	String	Defines the applicant entity type: `individual` — for applicants registered and checked as individuals. `company` — for applicants registered and checked as legal entities.
`correlationId`	String	Unique identifier of the event.
`sandboxMode`	Boolean	Set to `true` if the webhook was sent from Sandbox.
`externalUserId`	String	Unique applicant identifier as registered on your side. When creating an applicant, you can generate and add the `externalUserId` manually, or it will be automatically generated and added to the applicant profile by Sumsub.
`type`	String	Webhook type. In this context, it is `applicantKytOnHold`.
`reviewStatus`	String	Indicates the current transaction status (`init`, `onHold`, `completed`).
`createdAt`	Date	Date and time when the webhook was created (format `yyyy-MM-dd HH:mm:ss+0000`, e.g. `2021-05-14 16:00:25+0000`) in UTC.
`createdAtMs`	Date	Date and time when the webhook was created, considering milliseconds (format `yyyy-MM-dd HH:mm:ss.fff`, e.g. `2021-05-14 16:00:25.032`) in UTC.
`clientId`	String	Unique identifier of you as our client in the Sumsub system. This identifier is assigned to you when you are registered in and get access to the Sumsub system. It usually resembles your name or your company name. `clientId` is automatically added to the applicant profile when it is created.
`kytTxnId`	String	Unique transaction identifier (`.id`) on the Sumsub side.
`kytDataTxnId`	String	Unique transaction identifier (`data.txnId`) on your side.
`kytTxnType`	String	Transaction type. Expects values: `finance`(default) `kyc` `travelRule` `userPlatformEvent` `login` `signup` `passwordChange` `twoFaReset`

applicantKytTxnAwaitingUser

{
  "applicantId": "6447b564728bf40939a7664f",
  "applicantType": "individual",
  "correlationId": "7310f3ffddbff223cdf10221cdf12064",
  "sandboxMode": false,
  "externalUserId": "customExternalUserId",
  "type": "applicantKytTxnAwaitingUser",
  "reviewStatus": "awaitingUser",
  "createdAt": "2023-12-11 10:41:54+0000",
  "createdAtMs": "2023-12-11 10:41:54.431",
  "clientId": "coolClientId",
  "kytTxnId": "6576e772b2f80732714d1de0",
  "kytDataTxnId": "m26m980m9jd7pozq72se4",
  "kytTxnType": "finance"
}

Field	Type	Description
`applicantId`	String	Unique identifier of the applicant in the Sumsub system.
`applicantType`	String	Defines the applicant entity type: `individual` — for applicants registered and checked as individuals. `company` — for applicants registered and checked as legal entities.
`correlationId`	String	Unique identifier of the event.
`sandboxMode`	Boolean	Set to `true` if the webhook was sent from Sandbox.
`externalUserId`	String	Unique applicant identifier as registered on your side. When creating an applicant, you can generate and add the `externalUserId` manually, or it will be automatically generated and added to the applicant profile by Sumsub.
`type`	String	Webhook type. In this context, it is `applicantKytTxnAwaitingUser`.
`reviewStatus`	String	Indicates the current transaction status (`init`, `onHold`, `completed`).
`createdAt`	Date	Date and time when the webhook was created (format `yyyy-MM-dd HH:mm:ss+0000`, e.g. `2021-05-14 16:00:25+0000`) in UTC.
`createdAtMs`	Date	Date and time when the webhook was created, considering milliseconds (format `yyyy-MM-dd HH:mm:ss.fff`, e.g. `2021-05-14 16:00:25.032`) in UTC.
`clientId`	String	Unique identifier of you as our client in the Sumsub system. This identifier is assigned to you when you are registered in and get access to the Sumsub system. It usually resembles your name or your company name. `clientId` is automatically added to the applicant profile when it is created.
`kytTxnId`	String	Unique transaction identifier (`.id`) on the Sumsub side.
`kytDataTxnId`	String	Unique transaction identifier (`data.txnId`) on your side.
`kytTxnType`	String	Transaction type. Expects values: `finance`(default) `kyc` `travelRule` `userPlatformEvent` `login` `signup` `passwordChange` `twoFaReset`

applicantKytTxnDataChanged

{
  "applicantId": "6447b564728bf40939a7664f",
  "applicantType": "individual",
  "correlationId": "fb36d7a2f2e1ac15773ec9a56f999dde",
  "sandboxMode": false,
  "externalUserId": "customExternalUserId",
  "type": "applicantKytTxnDataChanged",
  "reviewResult": {
    "reviewAnswer": "GREEN"
  },
  "reviewStatus": "completed",
  "createdAt": "2024-01-24 07:38:34+0000",
  "createdAtMs": "2024-01-24 07:38:34.994",
  "clientId": "coolClientId",
  "kytTxnId": "6576e772b2f80732714d1de0",
  "kytDataTxnId": "m26m980m9jd7pozq72se4",
  "kytTxnType": "finance"
}

Field	Type	Description
`applicantId`	String	Unique identifier of the applicant in the Sumsub system.
`applicantType`	String	Defines the applicant entity type: `individual` — for applicants registered and checked as individuals. `company` — for applicants registered and checked as legal entities.
`correlationId`	String	Unique identifier of the event.
`sandboxMode`	Boolean	Set to `true` if the webhook was sent from Sandbox.
`externalUserId`	String	Unique applicant identifier as registered on your side. When creating an applicant , you can generate and add the `externalUserId` manually, or it will be automatically generated and added to the applicant profile by Sumsub.
`type`	String	Webhook type. In this context, it is `applicantKytTxnDataChanged`.
`reviewResult`	Object	Contains extra information on the transaction verification results.
`reviewStatus`	String	Indicates the current transaction status (`init`, `onHold`, `completed`).
`createdAt`	Date	Date and time when the webhook was created (format `yyyy-MM-dd HH:mm:ss+0000`, e.g. `2021-05-14 16:00:25+0000`) in UTC.
`createdAtMs`	Date	Date and time when the webhook was created, considering milliseconds (format `yyyy-MM-dd HH:mm:ss.fff`, e.g. `2021-05-14 16:00:25.032`) in UTC.
`clientId`	String	Unique identifier of you as our client in the Sumsub system. This identifier is assigned to you when you are registered in and get access to the Sumsub system. It usually resembles your name or your company name. `clientId` is automatically added to the applicant profile when it is created.
`kytTxnId`	String	Unique transaction identifier (`.id`) on the Sumsub side.
`kytDataTxnId`	String	Unique transaction identifier (`data.txnId`) on your side.
`kytTxnType`	String	Transaction type. Expects values: `finance`(default) `kyc` `travelRule` `userPlatformEvent` `login` `signup` `passwordChange` `twoFaReset`

Transaction monitoring webhooks

📘
Note

👍
Tip

applicantKytTxnApproved

applicantKytTxnRejected

applicantKytTxnReviewed

applicantKytTxnDeleted

applicantKytOnHold

applicantKytTxnAwaitingUser

applicantKytTxnDataChanged

📘Note

👍Tip

applicantKytTxnApproved

applicantKytTxnRejected

applicantKytTxnReviewed

applicantKytTxnDeleted

applicantKytOnHold

applicantKytTxnAwaitingUser

applicantKytTxnDataChanged

📘
Note

👍
Tip