Registering a reference bank account

Prerequisites

You can register a reference bank account as soon as you have created a user. The registration of a reference bank account is required to complete the onboarding process and therefore to activate the account.

To register a reference bank account, we require you to provide:

• Bank account owner name which matches the name of the user on the Investment API
• IBAN (International Bank Account Number) of the account
• BIC (Bank Identifier Code) of the account
• A timestamp of the confirmation of your user to register the reference bank account

Other optional fields are available to assign a name to the reference bank account that is more human readable.

Since we currently only support securities accounts for individuals, the name of the reference bank account owner must match the name of the user on the Investment API. Also, we currenly support Euro SEPA bank accounts only.

Once the required information is collected and validated, you register the bank account as follows:

POST /payments/reference_accounts.

Example request

{
  "user_id": "83d83ec2-d2ca-49ff-bbea-b92b5c3be202",
  "account_owner": "Max Mustermann",
  "name": "Max's Reference Account",
  "iban": "DE02100500000054540402",
  "bic": "BELADEBE",
  "confirmed_at": "2020-08-23T14:15:22Z"
}