Link Multiple Accounts

API Description

If one person has multiple accounts, you can link these accounts together so the customers have to do KYC once. The only step you need to do is call add-account-info-list API

This is also the relevant endpoint for utilizing Oauth Link.

HTTP Request

POST /bapi/ekyc/v2/public/ekyc/customer/add-account-info-list

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
accountList	LIST	YES	Account relation list

Account relation list

Name	Type	Mandatory	Description
entityCustomerId	STRING	YES	customer id，that is, the user id of the access entity site, Not Required for Oauth Link
openId	STRING	NO	Required for Oauth Link
oauthClientId	STRING	NO	Required for Oauth Link
brokerMainAccountId	STRING	YES	Broker main account id
brokerSubAccountId	STRING	YES	Broker sub account id

Response Fields

Name	Type	Mandatory	Description
code	STRING	YES	error code，000000000 is success

Request Body Example

{
    "bizEntityKey": "BROKERKEY",
    "accountList": [{
        "entityCustomerId": "ABC",
        "brokerSubAccountId": "2789382993653477377",
        "brokerMainAccountId": "123456789"
    },
    {
        "entityCustomerId": "ABC",
        "brokerSubAccountId": "2789382993653477377",
        "brokerMainAccountId": "123456789"
    }
    
    ]
}

Response Example

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