After an account holder is created, you can update its details and provide more information about the address, bank account, shareholders, and other data required for KYC verification.
In addition, you can change the status of the account holder or set up a new beneficiary for one of its accounts, as shown in this document.
Update account holder details
When you get more information about a sub-merchant or want to change some of the details submitted previously, pass new values along with the
/updateAccountHolder request. In this request, provide the
accountHolderCode value to specify the account holder to be updated.
Update business details
The following example demonstrates how to change business details of an account holder using the
Update bank account details
The following example demonstrates how to change bank account details of an account holder using the
To add or update shareholders for a business account holder, pass their details in the
/updateAccountHolder request. When updating the details of an existing shareholder, ensure to provide the
Update account holder state
To update an account holder's state, make a request to the
/updateAccountHolderState endpoint and specify the
accountHolderCode value to identify the account holder. In this request, pass the state to be modified (
Payout) using the
stateType parameter, and the new state value using the
Set up a beneficiary
/setupBeneficiary call you can set up a beneficiary for an existing account, which means that all the balance and transactions will be transferred to the beneficiary. After this operation, no transactions are booked on the source account, but all are forwarded to the new beneficiary instead.
When you make the
/setupBeneficiary call for a source account that was already used as a destination account, the number of subsequent beneficiary transfers is limited to 2.
account1 → account2 → account3 is OK.
account1 → account2 → account3 → account4 is not allowed.
By default, the
/setupBeneficiary call is disabled for your marketplace. To enable it, contact Support Team.