Check KYC Status

Tip

• All requests use POST
• Content type is application/json

Brief Description

Use this API to query a user's latest KYC status by mobile phone number.

If KYC is approved, the system increases the user's limit automatically. If KYC is rejected, the user must submit a new KYC application and upload the verification documents again.

Request URL

• /v1/vexora/kycStatusQuery

Request Method

• Method: POST
• Content-Type: application/json

Header

Header	Required	Type	Description
merchantNo	Yes	String	Merchant number assigned by Vexora.

Request Body Parameters

Parameter	Required	Type	Description
sign	Yes	String	Request signature. Sort all non-empty request body parameters except sign by parameter name in ascending alphabetical order, concatenate them as key1=value1key2=value2, append the app secret, and generate a lowercase MD5 hash.
timestamp	Yes	String	Request timestamp in milliseconds, for example 1715941383720.
mobile	Yes	String	User's actual mobile phone number. For Cambodia mobile numbers, use 8 to 9 digits without the country code.

Request Example

{
  "sign": "363b4674a1c1772e8a50295dc19d6727",
  "timestamp": "1732988442913",
  "mobile": "104837292"
}

Response Parameters

Parameter	Required	Type	Description
msg	Yes	String	Request message. A value such as success only indicates that the query request was accepted, not the final KYC result.
code	Yes	String	API request status code. 0000 means the request was processed successfully by the API layer. Refer to the Response Code section for other values.
timestamp	Yes	Integer	Response timestamp in milliseconds.
success	Yes	Boolean	Whether the query request was processed successfully. This field does not represent the final KYC result.
data	Yes	Object	KYC status response object.
data.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.
data.failReason	No	String	Reason for rejection. This field is returned when KYC is rejected.

Response Example

{
  "msg": "success",
  "code": "0000",
  "timestamp": 1728609277476,
  "success": true,
  "data": {
    "authenticationStatus": "3",
    "failReason": "The file and type do not match"
  }
}