Skip to main content
The Webhook feature supports real-time data integration with your system. When specific events occur, HTTP POST requests are sent to your configured endpoint URL, allowing you to receive real-time notifications and process data without separate API calls.

Use Cases

When a new customer’s KYC verification is completed at a financial institution, receive immediate notification via webhook to automatically proceed with subsequent processes such as account opening, card issuance, and service activation. Based on approval or rejection status, send customized notification messages to customers or take actions like requesting additional documents.
When KYC submissions are rejected or specific risk factors are detected, send immediate notifications to operations teams via webhook for rapid response. Combined with email notification functionality, allow staff to understand situations in real-time and provide customer support.
Send real-time data related to KYC verification status to BI systems or data warehouses for use in real-time dashboard configuration or statistical analysis.
Security and StabilityWebhook endpoints should use HTTPS to ensure secure data transmission. We also recommend implementing signature verification mechanisms to confirm the authenticity of webhook requests.

Step 1: Access Webhook Settings Page

Access the Settings → Webhook menu in the dashboard to configure webhook functionality.
Webhook Email Notification Settings Screen

Webhook and Email Notification Settings


Step 2: Email Notification Settings

Configure email notifications to receive when webhook events occur.
Notifications are sent to configured email addresses when key status changes occur, such as KYC submission completion, approval, or rejection.
SettingDescription
Notification Email AddressEnter email address to receive webhook event notifications.
Event Type SelectionSelect events you want to be notified about, such as KYC submission completion, approval, rejection.
Real-time NotificationsEmail notifications are sent immediately when configured events occur.
After entering the email address to receive, click the ‘Add’ button to complete the settings.

Step 3: Endpoint URL Configuration

Configure the endpoint URL where your system will receive webhook data. HTTP POST requests are sent to the configured URL when webhook events occur.
Webhook IP and URL ManagementFixed webhook IPs for each project can only be viewed on this page, and webhook URL change history is not stored, so please manage webhook URLs carefully.

Step 4: Webhook Testing and Verification

After webhook configuration is complete, verify normal operation as follows:
1

Generate Test Event

Generate test events to verify webhook delivery.
2

Confirm Data Receipt

Confirm webhook data receipt in your system.
3

Verify Email Notification

Verify normal email notification receipt.
4

Modify if Needed

Modify endpoint URL or email address if needed.
Webhook endpoints should be implemented to respond reliably, and development should consider retransmission scenarios due to network failures, etc.

Benefits of Webhook Functionality

Real-time Integration

Immediate system integration through real-time event notifications.

Efficient Data Receipt

Efficient data receipt without separate API polling.

Real-time Monitoring

Real-time monitoring by staff through email notifications.

Automation Support

Support for automated follow-up process integration.

Webhook Event Types

EventDescription
approvedTriggered when KYC verification is approved
rejectedTriggered when KYC verification is rejected
retryTriggered when retry occurs
updatedTriggered when submission information is updated
deleteTriggered when submission is deleted
submitTriggered when new submission is completed
tokenTriggered on token-related events
injectionTriggered on data injection
amlTriggered on AML screening results
aml-ongoingTriggered on AML ongoing monitoring results