Sign in
Reference accounts

Create a reference account for a business

Adds an external bank account as a reference account to the business' Solaris account specified in the request URL.<br> Note: Before calling this endpoint, you must create a SEPA Direct Debit mandate and have the customer sign it.

post/v1/businesses/{business_id}/accounts/{account_id}/reference_accounts

Path parameters

business_idstring required
account_idstring required

Request body

namestring

The name of the external account holder.

ibanstring

IBAN of the reference account.

mandate_numberstring

The identifier of the SDD mandate that the customer signed.

mandate_signature_datestring date

The date when the customer signed the SDD mandate.

mandate_type'B2B' | 'Core'

The type of SDD mandate.

Example request

{
  "name": "account_holder_unique_ref",
  "iban": "DE32110101001000000029",
  "mandate_number": "example-mandate-number",
  "mandate_signature_date": "2020-01-08",
  "mandate_type": "Core"
}

Response

The operation was successful.

idstring

Unique ID of the reference account.

statusstring

Current status of the reference account.

namestring

The reference account holder's name.

ibanstring

The reference account's IBAN.

mandate_numberstring

The number of the SDD mandate associated with the reference account.

mandate_signature_datestring date

The date when the customer signed the SDD mandate.

mandate_type'B2B' | 'Core'

The type of SDD mandate.

Example response

{
  "id": "ee4cc80bee604de09d036d8b7a9b6cb0",
  "status": "ACTIVE",
  "name": "Max Mustermann",
  "iban": "DE32110101001000000029",
  "mandate_number": "example-mandate-number",
  "mandate_signature_date": "2020-01-08",
  "mandate_type": "Core"
}