Skip to content
/Bank statements

Account management (1.0)

Download OpenAPI description
account-management.json
account-management.yaml
Languages
Servers
Mock Server

https://docs.solarisgroup.com/_mock/api-reference/digital-banking/account-management/

Accounts

Operations

Person accounts

Operations

Business accounts

Operations

Reference accounts

Operations

Account closure requests

Operations

Fee collection

Operations

Reservations

Operations

Seizures

Operations

Bank statements

Operations

Create a bank statement for an account

Request

Generates a bank statement for the account specified in the request URL. You must provide a start_date and an end_date. The API will return all bookings with a valuta_date that falls on and between these two dates. You may set the start_date to a date before the account was opened, but do not provide this option to your customers in your frontend.
Note: This request is idempotent. If you attempt multiple requests with the same start_date and end_date, then the API will return a 200 response with the data produced by the original request.

Path
account_idstringrequired
Bodyapplication/json

The content of the request.

start_datestring(date)required

The starting date from which to return bookings for the account.

Example: "2016-05-24"
end_datestring(date)required

The ending date for the bank statement. Must be a later date than the start_date.

Example: "2016-05-31"
application/json
{
  "start_date": "2016-05-24",
  "end_date": "2016-05-31"
}

Responses

The statement has already been created for the given dates.

Bodyapplication/json
idstring

ID of the bank statement.

Example: "4463f72f46cc9233c5494146f01b152ccsas"
recipient_informationobject

The recipient's name and address.

issue_datestring(date)

Date when the statement was issued.

Example: "2022-04-01"
statement_period_start_datestring(date)

The beginning date of the period covered by the statement.

Example: "2022-03-01"
statement_period_end_datestring(date)

The end date of the period covered by the statement.

Example: "2022-03-31"
overdraft_facilityobject

Overdraft facility that has been granted to the customer.

Example: {"value":10000,"unit":"cents","currency":"EUR"}
account_informationobject

Object containing the account's IBAN, BIC, and balance information.

disclaimerstring

Solaris' legal disclaimer text, which you must show to the customer.

Example: "Sehr geehrte Kundin, sehr geehrter Kunde,\\nbitte prüfen Sie die Buchungen, Berechnungen und den Abschlusssaldo im beiliegenden Kontoauszug, der zugleich einen Rechnungsabschluss darstellt. Rechnungsabschlüsse gelten als genehmigt, sofern Sie innerhalb von sechs Wochen nach Zugang keine Einwendungen erheben. Einwendungen gegen Rechnungsabschlüsse müssen der solarisBank schriftlich oder in Textform (z.B. an support@solarisbank.de) zugehen. Im Falle der Einwendung in Textform genügt zur Fristwahrung die rechtzeitige Absendung. Der angegebene Kontostand berücksichtigt nicht die Wertstellung der einzelnen Buchungen. Dies bedeutet, dass der genannte Betrag nicht dem für die Zinsrechnung maßgeblichen Kontostand entsprechen muss und bei Verfügungen möglicherweise Zinsen für die Inanspruchnahme einer eingeräumten oder geduldeten Kontoüberziehung anfallen können. Gutschriften aus eingereichten Lastschriften und anderen Einzugspapieren erfolgen unter dem Vorbehalt der Einlösung. Guthaben sind als Einlagen nach Maßgabe des Einlagensicherungsgesetzes entschädigungsfähig. Nähere Informationen können dem Informationsbogen für den Einleger entnommen werden, den Sie gemeinsam mit unseren für den Geschäftsverkehr mit Ihnen geltenden Allgemeinen Geschäftsbedingungen und besonderen Bedingungen unter www.solarisbank.de/partner einsehen können.\\nMit freundlichen Grüßen\\nIhre solarisBank"
Response
application/json
{
  "id": "4463f72f46cc9233c5494146f01b152ccsas",
  "recipient_information": {
    "line_1": "Mr. Peter Mustermann",
    "line_2": "Musterstrasse 23",
    "line_3": "10409 Berlin",
    "line_4": "DE",
    "line_5": "string",
    "line_6": "string"
  },
  "issue_date": "2022-04-01",
  "statement_period_start_date": "2022-03-01",
  "statement_period_end_date": "2022-03-31",
  "overdraft_facility": {
    "value": 10000,
    "unit": "cents",
    "currency": "EUR"
  },
  "account_information": {
    "iban": "DE76110101001100000999",
    "bic": "SOBKDEBBXXX",
    "balance_start": { … },
    "balance_end": { … }
  },
  "disclaimer": "Sehr geehrte Kundin, sehr geehrter Kunde,\\nbitte prüfen Sie die Buchungen, Berechnungen und den Abschlusssaldo im beiliegenden Kontoauszug, der zugleich einen Rechnungsabschluss darstellt. Rechnungsabschlüsse gelten als genehmigt, sofern Sie innerhalb von sechs Wochen nach Zugang keine Einwendungen erheben. Einwendungen gegen Rechnungsabschlüsse müssen der solarisBank schriftlich oder in Textform (z.B. an support@solarisbank.de) zugehen. Im Falle der Einwendung in Textform genügt zur Fristwahrung die rechtzeitige Absendung. Der angegebene Kontostand berücksichtigt nicht die Wertstellung der einzelnen Buchungen. Dies bedeutet, dass der genannte Betrag nicht dem für die Zinsrechnung maßgeblichen Kontostand entsprechen muss und bei Verfügungen möglicherweise Zinsen für die Inanspruchnahme einer eingeräumten oder geduldeten Kontoüberziehung anfallen können. Gutschriften aus eingereichten Lastschriften und anderen Einzugspapieren erfolgen unter dem Vorbehalt der Einlösung. Guthaben sind als Einlagen nach Maßgabe des Einlagensicherungsgesetzes entschädigungsfähig. Nähere Informationen können dem Informationsbogen für den Einleger entnommen werden, den Sie gemeinsam mit unseren für den Geschäftsverkehr mit Ihnen geltenden Allgemeinen Geschäftsbedingungen und besonderen Bedingungen unter www.solarisbank.de/partner einsehen können.\\nMit freundlichen Grüßen\\nIhre solarisBank"
}

Index bookings for a bank statement

Request

Returns an array containing all bookings that are contained within the account statement specified in the request URL.

Path
account_idstringrequired
statement_idstringrequired
Query
page[number]string

Returns a specific page of results.

page[size];string

Determines the size of each page of results.

No request payload

Responses

The operation was successful.

Headers
Totalinteger

Total number of bookings within this statement.

Per-Pageinteger

Number of bookings per page.

LinkArray of strings

Links to the first, last, next, and previous pages.

Bodyapplication/json
idstring

ID of the booking.

Example: "fe6561bdb526ed8866e9dac00bd1848ecboo"
creation_datestring

The date when the booking was created. Do not expose this to the account holder(s).

Example: "2022-01-18"
valuta_datestring

The valuta date of the booking (i.e., the date when the booking becomes effective).

Example: "2022-01-18"
booking_datestring

The date when the booking was posted.

Example: "2022-01-18"
booking_typestring(Solaris-Enums-BookingType)

The type of the booking. See the booking documentation for a list of explanations for each booking type.

Enum"CANCELLATION_BOOKING""CancellationCardTransaction""CANCELLATION_CARD_TRANSACTION_DIRECT""CANCELLATION_CHARGE_CARD""CANCELLATION_CHARGE_DUNNING""CANCELLATION_CHARGE_SEPA_DIRECT_DEBIT_RETURN""CANCELLATION_CRYPTO_EXCHANGE""CANCELLATION_CURRENCY_EXCHANGE_PARTNER""CANCELLATION_DIRECT_DEBIT""CANCELLATION_DOUBLE_BOOKING"
Example: "SEPA_CREDIT_TRANSFER"
amountobject

The amount of the booking.

Example: {"value":-160,"unit":"cents","currency":"EUR"}
descriptionstring

A description of the booking.

Example: "BERLINER VOLKSBANK EG, TXL ABFLUG"
purpose_codestring

The purpose code of the booking.

Example: "null"
recipient_bicstring

The recipient's BIC.

Example: "SOBKDEBBXXX"
recipient_ibanstring

The recipient's IBAN.

Example: "DE97110101002242911754"
recipient_namestring

The recipient's full name.

Example: "SURIA LUIS VENTURA VIERA PEREIRA RIBEIRO"
receiver_iban_virtualstring

(If applicable) The receiver's virtual IBAN.

sender_bicstring

The sender's BIC.

Example: "SOBKDEBBXXX"
sender_ibanstring

The sender's IBAN.

Example: "DE95110101000018501020"
sender_namestring

The sender's full name.

Example: "HANS MUSTERMANN"
end_to_end_idstring

SEPA identifier provided by the customer who initiated the SEPA transaction, routed through the entire payment process.

Example: "END2ENDREJ"
creditor_identifierstring

Unique reference that identifies a party collecting payments under the SEPA Direct Debit scheme within and across 32 countries. See the Deutsche Bundesbank's definition of creditor identifier for more information.

Example: "DE98ZZZ09999999999"
mandate_referencestring

The reference of the SDD mandate.

Example: "00000000000001"
transaction_idstring

The Solaris transaction ID.

Example: "d651ee23300b4e7c8fe7b7e2b2e96trx"
return_transaction_idstring

(If applicable) The Solaris ID of the return transaction.

Example: "758ea4a268974284ae7af17871f3fdc4"
sepa_chargesobject

(If applicable) Object containing information about the SEPA Direct Debit return transaction charges.

sepa_return_codestring or null

(If applicable) The SEPA reason code for the return transaction. See the EPC173-14 guidelines for more information.

Enum"AC01""AC03""AC04""AC06""AC13""AC14""AG01""AG02""AM01""AM02"
sepa_return_reasonstring

(If applicable) The SEPA return reason text as defined by ISO 20022.

sepa_return_reason_definitionstring

(If applicable) Explanation of the SEPA return reason code as defined by ISO 20022.

meta_infoobject or null
recorded_atstring

UTC timestamp from when the booking was recorded.

Example: "2022-01-24T00:41:57.634Z"
reconciliation_idstring

(If applicable) Unique ID of the related clearing transaction initiated by Solaris.

Example: "87271dda6e454393036b4ec2b64b2221itrx"
initiator_referencestring

Unique reference for the transaction's initiator.

charge_detailsstring

Transaction charge details. Only relevant for bookings with the type TARGET2_CREDIT_TRANSFER.

Enum"DEBT""SHAR""CRED"
Example: "CRED"
Response
application/json
{
  "id": "fe6561bdb526ed8866e9dac00bd1848ecboo",
  "creation_date": "2022-01-18",
  "valuta_date": "2022-01-18",
  "booking_date": "2022-01-18",
  "booking_type": "SEPA_CREDIT_TRANSFER",
  "amount": {
    "value": -160,
    "unit": "cents",
    "currency": "EUR"
  },
  "description": "BERLINER VOLKSBANK EG, TXL ABFLUG",
  "purpose_code": "null",
  "recipient_bic": "SOBKDEBBXXX",
  "recipient_iban": "DE97110101002242911754",
  "recipient_name": "SURIA LUIS VENTURA VIERA PEREIRA RIBEIRO",
  "receiver_iban_virtual": "string",
  "sender_bic": "SOBKDEBBXXX",
  "sender_iban": "DE95110101000018501020",
  "sender_name": "HANS MUSTERMANN",
  "end_to_end_id": "END2ENDREJ",
  "creditor_identifier": "DE98ZZZ09999999999",
  "mandate_reference": "00000000000001",
  "transaction_id": "d651ee23300b4e7c8fe7b7e2b2e96trx",
  "return_transaction_id": "758ea4a268974284ae7af17871f3fdc4",
  "sepa_charges": {
    "value": 5000,
    "unit": "cents",
    "currency": "EUR"
  },
  "sepa_return_code": "AC01",
  "sepa_return_reason": "string",
  "sepa_return_reason_definition": "string",
  "meta_info": "{\"cards\":{\"card_id\":\"abe6963e8be94364b8c1aa34d1bb5bc3mcrd\",\"merchant\":{\"id\":\"123456789101112\",\"country_code\":\"GB\",\"category_code\":\"5411\",\"name\":\"Grocery\",\"town\":\"London\"},\"original_amount\":{\"currency\":\"GBP\",\"value\":50000,\"fx_rate\":10.0,\"fx_markup\":7.3165,\"issuer_fee\":0.0},\"pos_entry_mode\":\"MANUAL_PAN_ENTRY\",\"trace_id\":\"382621b66280020528d9433d135c2ae418fa53d0\",\"transaction_id\":\"c158f11c-d6b2-4f8f-9391-ac20c2167f89\",\"transaction_date\":\"2024-10-18\",\"transaction_time\":\"2024-10-18T15:22:02+00:00\",\"auth_code\":\"053630\",\"acquirer_id\":\"123456\",\"terminal_id\":\"12345678\",\"transaction_type\":\"PURCHASE\"}}",
  "recorded_at": "2022-01-24T00:41:57.634Z",
  "reconciliation_id": "87271dda6e454393036b4ec2b64b2221itrx",
  "initiator_reference": "string",
  "charge_details": "CRED"
}

Statements of account

Operations

Fee summary statements

Operations

Person messages

Operations

Business messages

Operations

Trusted IBANs

Operations

Virtual IBANs

Operations

IBAN validation

Operations

Savings Accounts

Operations