Webhook Guide

Webhook

Webhook provides real-time notifications when specific events occur.

Webhook Integration

To integrate webhook, please send your webhook URL to your Argos Representative.

Webhook Triggers

"Submission data" only returns entered information. In cases when you do not include any optional information such as "cf1" or "wallet_address" in submission data, the response object does not include them either.

Trigger 1: When a KYC submission is made

KYC submission data is returned when the KYC submission process is complete.
Parameter
Description
email
Email address
created_at
Time when a KYC submission is complete
webhook_trigger
submit
submission_id
Submission ID
userid
Unique ID for each KYC applicant (≠ submission id)
Sample Response
1
{
2
"email":"[email protected]",
3
"created_at":"2020-08-27T11:47:17.345Z",
4
"webhook_trigger":"submit",
5
"submission_id":"1jrho7kecqsonc"
6
}
Copied!

Trigger 2: When a KYC application is rejected

KYC submission data is returned when KYC is rejected.
Parameter
Description
kyc_result
KYC result
status
rejected
comment
Detailed reason of KYC rejection
updated_at
Time when KYC is rejected
email
Email address
webhook_trigger
rejected
submission_id
Submission ID
userid
Unique ID for each KYC applicant (≠ submission id)
Sample Response
1
{
2
"kyc_result": {
3
"status": "rejected",
4
"comment": "The entered information does not match with your ID document.",
5
"updated_at": "2020-06-02T05:19:49.685Z"
6
},
7
"email": "[email protected]",
8
"webhook_trigger": "rejected",
9
"submission_id": "35sl57karv614s"
10
}
Copied!

Trigger 3: When a KYC application is approved

KYC submission data is returned when KYC is approved.
Parameter
Description
kyc_result
KYC result
status
approved
updated_at
Time when KYC is approved
email
Email address
webhook_trigger
approved
submission_id
Submission ID
userid
Unique ID for each KYC applicant (≠ submission id)
Sample Response
1
{
2
"kyc_result":{
3
"status":"approved",
4
"updated_at":"2020-08-27 21:51"
5
},
6
"webhook_trigger":"approved",
7
"email":"[email protected]",
8
"submission_id":"1jrho7kecqsonc"
9
}
Copied!

Trigger 4: When AML screening is complete

AML result and submission data are returned when AML screening is complete.
Parameter
Description
aml_result
AML screening result
currentstatus
Not Screened: no match found in AML database Red Flag : Search result matched with match found in AML database
risk_level_summary
(Not Screened, High, Medium, Low)
webhook_trigger
aml
submission_id
Submission ID
userid
Unique ID for each KYC applicant (≠ submission id)
Sample Response
Red Flag
Not Screened
1
{
2
"aml_result":{
3
"currentstatus":"Red Flag",
4
"risk_level_summary":"HIGH"
5
},
6
"webhook_trigger":"aml",
7
"email":"[email protected]",
8
"submission_id":"22d4r08kedv2m4d"
9
}
Copied!
1
{
2
"aml_result":{
3
"currentstatus":"Not Screened",
4
"risk_level_summary":"Not Screened"
5
},
6
"webhook_trigger":"aml",
7
"email":"[email protected]",
8
"submission_id":"1jrho7alsdksonc"
9
}
Copied!