KYC Webhook Configuration
Set up your kyc webhook endpoint in the merchant dashboard

Webhook Events
You receive the following events on your configured webhook endpoint, when the user is completing the KYC( Know Your Customer ) process on the Onmeta widget. All the event-names are present in eventName field in the webhook request body while description of the events are present in the message field
KYC Webhook Events - Event Names
# | EventName | Description |
---|---|---|
1 | KYCInit | KYC process has been initiated. |
2 | SelfieSuccess | Selfie step has been captured successfully. |
3 | SelfieFailure | Selfie step has been failed. |
4 | PanSuccess | Pan capture step has been captured successfully. |
5 | PanFailure | Pan capture step is failed. |
6 | AadhaarFrontSuccess | Aadhaar front capture step has been captured successfully. |
7 | AadhaarFrontFailure | Aadhaar front capture step failed. |
8 | AadhaarBackSuccess | Aadhaar Back capture step has been captured successfully. |
9 | AadhaarBackFailure | Aadhaar Back capture step failed. |
10 | KYCCompleted | KYC Process is completed. |
KYC Webhook - Messages
Selfie
Messages |
---|
selfie has already been verified! |
Too many failed attempts, please try after an hour! |
selfie is not accurate, please try again! |
selfie uploaded successfully! |
selfie could not be processed! |
PAN
Messages |
---|
User's PAN has already been verified |
please upload selfie before uploading pan document! |
Too many failed attempts, please try after an hour! |
A user with this PAN exists already! |
Face in PAN does not match with selfie! |
Pan not verified successfully! |
PAN verified successfully! |
Aadhaar
Messages |
---|
User's Aadhaar has already been verified |
Please upload selfie and pan before uploading aadhaar document! |
Too many failed attempts, please try after an hour! |
Please upload Aadhaar front only |
Please upload Aadhaar back only |
Aadhaar number does not match with the PAN card |
A user with this Aadhaar exists already! |
selfie not uploaded properly, please upload selfie again! |
Face in Aadhaar does not match with selfie! |
Aadhaar front verified successfully! |
Aadhaar front has to be uploaded before Aadhaar back |
aadhaar_back's details do not match with aadhaar_front_bottom's details |
Aadhaar verified successfully! |
Internal server error! please try again later. |
Webhook Request Body
Success Event
Failure Event