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.

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"
}