Sign in
Reference accounts

Create reference account for a person

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

post/v1/persons/{person_id}/accounts/{account_id}/reference_accounts

Path parameters

person_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.

Example request

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

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.

Example response

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