KYC Callback¶

Overview¶

When a KYC result becomes available, Vexora sends an HTTP POST request to the callBackUrl submitted in the KYC application.

After processing the notification successfully, the merchant must return the plain text response OK (case-sensitive). If Vexora does not receive OK, Vexora makes up to 8 notification attempts within 24 hours using the following intervals:

2s → 5s → 10s → 30s → 1h → 3h → 3h → 3h

If all notification attempts fail, use the Check KYC Status API to retrieve the latest result.

Warning

If the merchant callback server restricts requests by IP address, contact Vexora in advance to obtain the required IP whitelist information.

Request Method¶

Method: POST
Content-Type: application/json

Request Parameters¶

Parameter	Required	Type	Description
mobile	Yes	String	User's actual mobile phone number. For Cambodia mobile numbers, use 8 to 9 digits without the country code.
authenticationStatus	Yes	String	KYC status. `0`: Pending authentication; `1`: Under review; `2`: Approved; `3`: Rejected. If rejected, submit a new KYC application for the user.
timestamp	Yes	String	Notification timestamp in milliseconds.
sign	Yes	String	Notification signature used to verify the request.

Notification Example¶

{
  "mobile": "101603841",
  "authenticationStatus": "2",
  "timestamp": "1724740395968",
  "sign": "6a0aaf43d3b8e5fd8f73df5f63c9a5ce"
}

Merchant Response¶

Return the following plain text after the notification has been processed successfully:

OK