Kyc RFI Record Submit API

API Description

Kyc RFI Record Submit API

RFI Upload API is in async mode.
Upon completion, the system will notify the process result via notify webhook with eventType = USER-RFI-SUBMIT-RESULT
User can also use POST /bapi/ekyc/v2/public/ekyc/customer/query-submit-rfi-result to query the RFI status/result.

HTTP Request

POST /bapi/ekyc/v2/public/ekyc/customer/submit-rfi-record

Request Header

Name	Type	Mandatory	Description
X-SHA2-Signature	STRING	YES	Request Signature

Request Parameters

Name	Type	Mandatory	Description
bizEntityKey	STRING	YES	business entity key, each access entity has its own bizEntityKey
entityCustomerId	STRING	YES	customer id, that is, the user id of the access entity site.
kycType	STRING	YES	kyc type，USER
recordId	STRING	YES	Rfi Record Id, got from “RFI Records Query API” respons
fileDataList	List<KycFileGroupInfoVo>	YES	File data info list, KycFileGroupInfoVo

KycFileGroupInfoVo

Name	Type	Description
type	STRING	Rfi Record required file type, got from “RFI Records Query API” response
files	List<KycFileItemVo>	File url info list. Supported file extensions:jpg, jpeg, png, pdf, mp4, mov;File Size limit: <= 10M

KycFileItemVo

Name	Type	Description
fileUrl	STRING	file download url

Response Fields

Name	Type	Mandatory	Description
code	STRING	YES
data	OuterKycRFISubmitResponse	NO

OuterKycRFISubmitResponse

Name	Type	Description
requestNo	String	request biz No, used for query result later

Request Body Example

{
    "bizEntityKey": "BROKERKEY",
    "entityCustomerId": "45712345678999212345",
    "kycType": "USER",
    "recordId": "12345",
    "fileDataList": [{
        "type":"SOF",
        "files": [
            {"fileUrl": "https://image.cnbcfm.com/api/v1/image/104853635-GettyImages-870113330.jpg?v=1709055832&w=740&h=416&ffmt=webp&vtcrop=y"}
        ]
    } 
    ]
}

Response Example

{
    "code": "000000",
    "message": null,
    "messageDetail": null,
    "data": {
        "requestNo": "6286de2c976243a38ce4da8bebc403cf"
    },
    "success": true
}