KYC Webhook Configuration

4min

Set up your kyc webhook endpoint in the merchant dashboard

kyc endpoint setup
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. 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

JS




Failure Event

JS




Updated 02 Dec 2023
Did this page help you?