Skip to main content

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

NameTypeMandatoryDescription
X-SHA2-SignatureSTRINGYESRequest Signature

Request Parameters

NameTypeMandatoryDescription
bizEntityKeySTRINGYESbusiness entity key, each access entity has its own bizEntityKey
accountListLISTYESAccount relation list

Account relation list

NameTypeMandatoryDescription
entityCustomerIdSTRINGYEScustomer id,that is, the user id of the access entity site, Not Required for Oauth Link
openIdSTRINGNORequired for Oauth Link
oauthClientIdSTRINGNORequired for Oauth Link
brokerMainAccountIdSTRINGYESBroker main account id
brokerSubAccountIdSTRINGYESBroker sub account id

Response Fields

NameTypeMandatoryDescription
codeSTRINGYESerror 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
}