Webhook Notifications Overview
Webhook notifications provide updates on key events related to account creation and onboarding progress. Below is a summary of the key notification types, implementation guidelines, and best practices.
đź”” Notification Types
1. Account Creation & Status Updates
Receive updates when an account is created or its status changes.
-
Webhook Event ID:
50
-
Status Values:
1
= Created2
= Accepted3
= Denied4
= Blocked5
= KYC update requested6
= KYC update rejected7
= KYC update accepted
-
Payload Example:
{
"EventDate": "2015-11-01T16:44:55.883",
"AccountID": "37373",
"ProfileID": "93843",
"IntId": "32",
"ExtId": "jdkc",
"Status": "2"
}
2. Onboarding Progress Updates (Profile Status)
Track the onboarding journey through changes in profile status.
-
Webhook Event ID:
49
-
Status Values:
1
= Onboarding in progress2
= Under analysis3
= Accepted4
= Denied5
= Rejected
-
Payload Example:
{
"EventDate": "2015-11-01T16:44:55.883",
"AccountID": "37373",
"ProfileID": "454545",
"IntId": "32",
"ExtId": "jdkc",
"Status": "2"
}
đź’ˇ Account status is updated upon completion of KYC checks. Depending on whether controls are automatic or manual, results may take from a few minutes up to a maximum of 48 hours.
⚠️ Please note: Webhook notifications can be delayed by up to one hour. We recommend performing aGET
request after receiving a webhook to retrieve the latest information.
⚙️ Implementation Steps
-
Set Up Webhooks
Configure webhook endpoints to receive notifications for both account and profile status changes. -
Handle Notifications
Implement logic to process different notification types and update your systems accordingly. -
Monitor Status Continuously
Regularly check account and profile statuses to ensure onboarding is progressing as expected.