KYC Webhook Configuration

4min
Set up your kyc webhook endpoint in the merchant dashboard
kyc endpoint setup 
﻿
﻿
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.
﻿
Selfie
Webhook Events
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
Webhook Events
 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 
Webhook Events
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
JS
|
 {
 	"success": true,
 	"message": "selfie uploaded successfully!",
 	"createdAt": "2023-05-29T16:21:29.053Z",
 	"email": "sample.testing@email.com",
 	"webhookUrl": "https://your-kyc-webhook.com",
 	"tenantId": "63bff28c42e2ae343ed2829b"
 }
 {
 	"success": true,
 	"message": "selfie uploaded successfully!",
 	"createdAt": "2023-05-29T16:21:29.053Z",
 	"email": "sample.testing@email.com",
 	"webhookUrl": "https://your-kyc-webhook.com",
 	"tenantId": "63bff28c42e2ae343ed2829b"
 }
﻿
﻿
Failure Event
JS
|
 {
 	"success": false,
 	"message": "Too many failed attempts, please try after an hour!",
 	"createdAt": "2023-05-29T16:21:29.053Z",
 	"email": "sample.testing@email.com",
 	"webhookUrl": "https://your-kyc-webhook.com",
 	"tenantId": "63bff28c42e2ae343ed2829b"
 }
 {
 	"success": false,
 	"message": "Too many failed attempts, please try after an hour!",
 	"createdAt": "2023-05-29T16:21:29.053Z",
 	"email": "sample.testing@email.com",
 	"webhookUrl": "https://your-kyc-webhook.com",
 	"tenantId": "63bff28c42e2ae343ed2829b"
 }
﻿
﻿
Updated 13 Aug 2023
Did this page help you?
Mobile SDK
Docs powered by
Archbee