Bank accounts lists your own bank accounts that cash-outs are paid into, and lets you propose a new one. A proposed account receives no payout until a second person at your bank approves it.
The Investor portal has the same page in its account menu, with the same table and the same steps.
Steps
Open the page
Open the account menu and select Bank accounts.
Propose an account
- Select Propose a bank account.
- Pick the Token when the sheet asks for one. It asks only when you are a client for more than one asset or bank.
- Enter the Account holder and the “Bank”.
- Under Account details, choose “IBAN” and enter the IBAN. Or choose “Account number and bank identifier” and enter the “Account number” and the “BIC or bank identifier”.
- Select Review, check the summary and select “Propose account”.
The account must be your own. The sheet removes the spaces from what you typed before it sends the account.
Read the list
Only an Active account can receive a payout. A “Proposed” account shows “Waiting for your bank's approval”. The page does not show the reason your bank gave for a refusal or a revocation.
Troubleshooting
The account menu has no Bank accounts item
Your provider has not set you up as a client of a bank yet. Ask your provider to link you to the bank for the asset you hold.
The sheet refuses the IBAN or the account number
The sheet shows the reason under the field and keeps what you typed. An IBAN starts with two capital letters and two check digits, and its check digits must match the rest of the number. An account number and a bank identifier use capital letters and digits only.
The page says your bank accounts could not be read
Select Try again. Nothing has changed on your accounts.
The Withdraw dialog says there is no payout account
A bank cash-out needs an Active account for that asset. Select “Bank accounts” in the Withdraw dialog to open this page, propose the account and wait for your bank's approval.
The Withdraw dialog says your participant account is restricted
A cash-out is refused while your participant account is suspended, closed, terminated or restricted from withdrawals, whatever accounts you have. Ask an administrator of your organisation to lift a suspension, closure or restriction on your participant account status, then request the cash-out again. A terminated account cannot be restored.
API routes
GET /api/ lists your accounts and POST /api/ proposes one. Bank rail describes both.