Transaction monitoring
Transaction monitoring webhooks are used during monitoring of transactions issued by your applicants.
Webhook | Description |
---|---|
applicantKytTxnApproved | Transaction approved. |
applicantKytTxnRejected | Transaction rejected. |
applicantKytOnHold | Transaction status was set to onHold . |
applicantKytTxnAwaitingUser | Transaction status was set to awaitingUser . |
applicantKytTxnDataChanged | Transaction data was enriched by the service. |
amlCaseApproved | AML case was approved. |
amlCaseRejected | AML case was rejected. |
amlCaseOnHold | AML case was put on hold. |
Payload attributes
The following is a collection of attributes present in webhooks.
Name | Type | Optional | Description |
---|---|---|---|
applicantId | String | No | A unique applicant identifier. |
applicantType | String | Yes | The applicant type (company ) or (individual ). |
correlationId | String | No | A unique identifier of the event. |
sandboxMode | Boolean | No | Set to True if the webhook was sent from Sandbox. |
externalUserId | String | No | A unique user identifier on your side. |
type | String | No | The webhook type. |
reviewResult | Object | Yes | Field that contains extra information on transaction verification results. |
reviewStatus | String | No | The current transaction status. |
createdAtMs | Date | No | Date and time when the webhook was created (format yyyy-MM-dd HH:mm:ss.fff , e.g. 2021-05-14 16:00:25.032) in UTC. |
clientId | String | No | You unique identifier as our client. |
kytTxnId | String | No | A unique transaction identifier on our side (.id ). |
kytDataTxnId | String | No | A unique transaction identifier on your side (data.txnId ). |
Note
We do not send any personal data via webhooks. You can fetch all recognized data using this API method.
Payload examples
This section lists a collection of webhooks that you may receive during transaction monitoring.
Note
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",
"createdAtMs": "2022-10-24 12:42:07.143",
"clientId": "coolClientId",
"kytTxnId": "64a7dc05fbf57c624afcb72d",
"kytDataTxnId": "uauu08x44xexbohyh4lkp9"
}
applicantKytOnHold
{
"applicantId": "634829375766b80001a40152",
"applicantType": "individual",
"correlationId": "98d4dac61c977c1b3f81d6ab78d29c3c",
"sandboxMode": false,
"externalUserId": "customExternalUserId",
"type": "applicantKytOnHold",
"reviewStatus": "onHold",
"createdAtMs": "2022-10-24 12:44:32.341",
"clientId": "coolClientId",
"kytTxnId": "64a7dc05fbf57c624afcb72d",
"kytDataTxnId": "j8bqz29yn491vksi9qfydw"
}
applicantKytTxnRejected
{
"applicantId": "634829375766b80001a40152",
"applicantType": "individual",
"correlationId": "0f5a7c828bab750775564534fc0470a8",
"sandboxMode": false,
"externalUserId": "customExternalUserId",
"type": "applicantKytTxnRejected",
"reviewResult": {
"reviewAnswer": "RED",
"reviewRejectType": "FINAL"
},
"reviewStatus": "completed",
"createdAtMs": "2022-10-24 12:45:04.982",
"clientId": "coolClientId",
"kytTxnId": "64a7dc05fbf57c624afcb72d",
"kytDataTxnId": "j8bqz29yn491vksi9qfydw"
}
applicantKytTxnAwaitingUser
{
"applicantId":"6447b564728bf40939a7664f",
"inspectionId":"6447b564728bf40939a76650",
"applicantType":"individual",
"correlationId":"7310f3ffddbff223cdf10221cdf12064",
"levelName":"basic-kyc-level",
"sandboxMode":false,
"externalUserId":"customExternalUserId",
"type":"applicantKytTxnAwaitingUser",
"reviewResult":{
"reviewAnswer":"RED",
"rejectLabels":[
"FORGERY"
],
"reviewRejectType":"FINAL",
"buttonIds":[
"fake_editedId",
"fake"
]
},
"reviewStatus":"completed",
"createdAtMs":"2023-08-30 09:47:10.694",
"clientId":"coolClientId"
}
applicantKytTxnDataChanged
{
"applicantId":"6447b564728bf40939a7664f",
"inspectionId":"6447b564728bf40939a76650",
"applicantType":"individual",
"correlationId":"fb36d7a2f2e1ac15773ec9a56f999dde",
"levelName":"basic-kyc-level",
"sandboxMode":false,
"externalUserId":"customExternalUserId",
"type":"applicantKytTxnDataChanged",
"reviewResult":{
"reviewAnswer":"RED",
"rejectLabels":[
"BAD_PROOF_OF_ADDRESS"
],
"reviewRejectType":"RETRY",
"buttonIds":[
"proofOfAddress_listOfDocs",
"proofOfAddress"
]
},
"reviewStatus":"completed",
"createdAtMs":"2023-08-30 09:52:44.301",
"clientId":"coolClientId"
}
amlCaseApproved
{
"correlationId":"26e4b45a9a0e3e8715de1b8dba0851fa",
"sandboxMode":false,
"type":"amlCaseApproved",
"reviewResult":{
"reviewAnswer":"GREEN"
},
"reviewStatus":"completed",
"createdAtMs":"2023-08-30 10:03:20.907",
"amlCaseId":"64baa015ebc52e736d147e8c"
}
amlCaseRejected
{
"correlationId" : "f1510d9aee2f7d30c7eb33cb59f24c3c",
"sandboxMode" : false,
"type" : "amlCaseRejected",
"reviewResult" : {
"reviewAnswer" : "RED"
},
"reviewStatus" : "completed",
"createdAtMs" : "2023-08-30 10:02:36.496",
"amlCaseId" : "63652066f11034000121a52b"
}
amlCaseOnHold
{
"correlationId":"da9564f4437c9fcd059f99e0b94fa04d",
"sandboxMode":false,
"type":"amlCaseOnHold",
"reviewResult":{
"reviewAnswer":"YELLOW"
},
"reviewStatus":"onHold",
"createdAtMs":"2023-08-30 09:59:52.864",
"amlCaseId":"63d7d1bac92045720c5e354a"
}
Updated 5 days ago