Introduction

After the user initiates a KYC request, the merchant can call this API to update the user’s KYC status.

It can be used in conjunction with the KYC webhook.

API Description

Request Method: POST

Request Path: open/api/kyc/getKycStatus/v2

Request Parameters

Response Parameters

Body Parameters:

Parameter	Type	Description
success	boolean	success
error	boolean	error
code	string	return code
msg	string	return message
traceId	string	traceId
model	object	response entity

Model Entity Description

Parameter	Type	Description
kycStatus	string	kyc status

KYC Status Description

Parameter	Description
NOT_INIT	KYC has not yet started
CA_COMPLETED_PENDING_SCAN	Part 1 registration is complete; preparing for identity scanning.
PROCESSING_SCAN	User scans passport, waiting for information processing (approximately 15-20 seconds).
PENDING_ACTION	Customer needs to take action to complete KYC, such as passport not yet scanned, or already scanned but requiring rescanning, or needing to re-add address.
COMPLETED	KYC success
MANUAL_REVIEW	KYC submitted, but still under manual review due to regulatory reasons.
REJECTED	KYC failed

Response Parameter Example:

{
    "code": "0",
    "msg": "SUCCESS",
    "model": {
        "kycStatus": "COMPLETED"
    },
    "traceId": "6655923745b9b37cb000187a035002030",
    "success": true,
    "error": false
}