Release notes

2024-02-20

Added

Changed

  • POST Create a secure view for card details: Added more instructions for generating the signature. The API reference now contains more details on how to generate a single string from the jwk_key representation of the public part of the rsa_key.

2024-01-22

Changed

  • Postbox Items endpoints: Updated the description of the field customer_confirmation in the endpoint response.
  • Booking types: Corrected the name of the SepaInstantCreditTransfer booking type value to SEPAInstantCreditTransfer.

Removed

2024-01-05

Changed

2023-12-22

Changed

2023-12-08

Added

2023-12-01

Changed

Deleted

  • POST Validate an IBAN: The API no longer returns the properties bank_code and account_number in the response.

2023-11-24

Added

Changed

2023-11-10

Added

Changed

2023-11-03

Added

2023-10-31

Added

  • GET List account bookings: Added the full list of enum values returned by the API for the sepa_return_code property on the booking resource.

Changed

  • POST Replace a card: Updated the endpoint description to indicate which card status values are required for the "reissue," "replace," and "lost/stolen" use cases, respectively.

2023-10-30

Added

  • You can now subscribe to the Solaris API docs newsletter to receive e-mail notifications whenever updates are published to this site. Scroll down to the bottom of any page on this site to find the sign-up form.

2023-10-20

Added

  • Account management guide: Added a note that overdraft information shown in an account statement represents the status of the overdraft on the date the statement was generated. Partners need to include this as well in statements shared with the end customers.

Changed

2023-10-18

Added

Changed

  • API reference: Fixed instances where API error responses would include the details property instead of detail.

2023-10-10

Changed

2023-09-28

Changed

2023-09-22

Changed

  • Consumer Overdrafts guide: Reviewed the guide and made language changes to make the guide more concise and added new diagrams. Added the following sections:

    • Overdraft limit change requests: Added a new section to explain the limit change request process and related endpoints.
    • [Overdraft limit change request status]: Added a new appendix for the status values and a new status flow diagram.

2023-09-04

Added

Changed

  • Onboarding requirements - Legal and compliance screens: Removed text related to FATCA reporting from the business tax declaration text. The screenshots below show a comparison of the previous vs. current versions, with the removed text highlighted in red. The removed text is also provided below.

    • English:
      Text removed from English version of business tax declaration text

      It should be noted that Solaris uses this form to collect data according to the FATCA Agreement and the German Law on the Automatic Exchange of Financial Account Information in Tax Matters (Finanzkonten- Informationsaustauschgesetz – FKAustG), according to which German financial institutions are required to collect all relevant data from their account holders and verify their plausibility.
      In case of reportable US citizens or companies, or organizations subject to the tax law of a CRS-participating state (except Germany), the following information must be reported annually to the German Federal Tax Office (Bundeszentralamt für Steuern - BZSt): (i) certain personal data such as name, address, date of birth, and the tax identification number (or their functional equivalent); (ii) account information and/ or participation information such as participation percentage, gross income, etc. If a passive NF(F)E comprises controlling entities who are US persons or are resident for tax purposes of a participating state (except Germany), the above data is also reported together with the data pertaining to controlling entities.
      Following the notification of this information to the BZSt, it is forwarded to the U.S. Tax Authority (IRS) or to the competent tax authority (-ies) of other CRS-participating states.

    • German:
      Text removed from German version of business tax declaration text

      Es wird darauf verwiesen, dass die Solaris SE mit diesem Formular Daten gemäß dem FATCA-Abkommen und dem FKAustG er- hebt. Danach sind deutsche Finanzinstitute dazu verpflichtet, alle relevanten Daten von ihren Kontoinhabern zu erheben und auf Plausibilität zu prüfen. Im Falle von meldepflichtigen U.S. Personen bzw. Gesellschaften oder in einem CRS- teilnehmenden Staat (außer Deutschland) steuerlich ansässigen Gesellschaften sind die folgenden Informationen jährlich an das Bundeszentralamt für Steuern (BZSt) zu melden: (i) bestimmte personenbezogene Daten wie Name, Adresse, Geburtsdatum und die Steueridentifikationsnummer (bzw. deren funktionale Entsprechung) sowie (ii) Konto- bzw. Beteiligungsinformationen wie Beteiligungshöhe, Bruttoerträge etc. Wenn ein Passiver NF(F)E beherrschende Personen hat, welche U.S. Personen sind oder in einem CRS-teilnehmenden Staat (außer Deutschland) steuerlich ansässig sind, so werden die obigen Daten zusammen mit den relevanten Daten der beherrschenden Personen ebenso gemeldet. Im Anschluss an die Meldung der Informationen an das BZSt werden die Informationen an die U.S.- Steuerbehörde (IRS) oder an den/die zuständige(n) Steuerbehörde(n) anderer CRS-teilnehmender Staat(en) weitergeleitet.

  • OVERDRAFT_LIMIT_CHANGE webhook payload: Changed the webhook event payload.

2023-08-31

Changed

2023-08-29

Added

2023-08-25

Added

Changed

  • Cards API: All transaction-related endpoints have been assigned the tag "Card transactions." The tag "Cards Smart Agent" was replaced.
  • Block and Unblock a card endpoints: Changed the response schema type from an array to an object.

2023-08-21

Changed

  • Seizures guide: Added clarification on when to send seizure notifications to active vs. inactive customers.

2023-08-16

Added

  • Account Closure guide: Added new section about the new field failure_reason and its possible values.
  • Account Closure guide: Added new validation for account closure requests for SDDs. Solaris will postpone the processing of an ACR in case an SDD was pulled from the account in the last 56 days. This validation is only relevant for Decoupled and Credit Cards products.
  • Account Closure webhooks: Added new webhook event ACCOUNT_CLOSURE_REQUEST_UPDATE to notify of certain status transitions for account closure requests (ACR).

Changed

2023-08-14

Added

  • B2B Fronting loans: New status added cdd_pending for B2B Fronting and B2B Fronting Factoring. The application status will transition to cdd_pending when Solaris triggers the CDD checks for the business. If any of the CDD checks fails, the application will be rejected.
  • [B2B Fronting loans]: Customer Due Diligence is now mandatory for B2B Fronting and Fronting Factoring. The customer must pass the CDD checks before they can be onboarded. Note: Enhanced Due Diligence is not relevant for this use case. Only green or red CDD statuses are possible.
  • Person identifications API: Added missing enum values for account_verification_error field.

Changed

  • Booking types: The booking type Target2CreditTransfer has changed to TARGET2_CREDIT_TRANSFER.

2023-08-07

Changed

2023-08-02

Added

  • SMS service: New endpoint added to send generic SMS messages to your customers. This endpoint can be used in the context of any product or business use case that require sending informational texts to customers.

Changed

  • AML update process: Updated the data points to confirm. The fields email and contact_address have been removed from all countries and customer segements. Added the fields in the address object for accuracy in all countries and customer segments.

2023-07-27

Added

Changed

2023-07-25

Added

  • [Consumer Overdrafts]: Added a new endpoint to terminate a consumer overdraft.

Changed

2023-07-24

Added

2023-07-20

Added

2023-07-11

Added

Changed

Removed

2023-07-07

Added

  • [Cards creation & servicing]: Added two new fields: key_id and encrypted_pin to the endpoint Create a card endpoint, along with instructions on how to set an encrypted PIN for the card using this endpoint.
  • Consumer Overdrafts: Add a new application status for consumer overdraft applications deleted. Solaris deletes failed applications in compliance with GDPR.
  • [Encrypted PIN change service]: Added a new endpoint to retrieve latest public key: GET Retrieve latest public key.

Changed

2023-06-29

Added

  • Cards transaction simulator API: New endpoint: POST Simulate an expired card authorization
  • Credit cards API:

    • New property added to credit card application resource: statement_with_details
    • New enum values added to credit card application upcoming_billing_cycle and current_billing_cycle properties:
    • WEEKLY
    • BIWEEKLY
    • MONTHLY
    • QUARTERLY
  • Fee Collection API:

    • Added a table of fee types and definitions to the API reference.
    • Added new enum values to the type property of a fee transaction:
    • ChargeATM
    • ChargeATMForeignCurrency
    • ChargeCard
    • ChargeVirtualCard
    • ChargeReissuePhysicalCard
    • ChargeAdditionalPhysicalCard
    • ChargeAdditionalVirtualCard
    • ChargeReissueVirtualCard
    • ChargeCardMaintenance
    • BoosterPackage
    • ChargeAccountMaintenance
    • ChargeTopUpCard
    • ChargeAdditionalAccountMaintenance
    • ChargeSharedAccount
    • ChargeAuthorizedUser
    • ChargeGamblingTransactionPartner
    • ChargeSEPAInstantOutgoing
    • ChargeSEPAInstantIncoming
    • ChargeManualSepaTransferPartner
    • ChargeIncomingSwift
    • ChargeGamblingOrCashEquivalent
  • Person identifications API: New endpoint: (Manual KYC only) POST Mark identification as failed

Changed

2023-06-28

Added

Changed

2023-06-23

Added

Changed

2023-06-21

Added

Changed

  • GET Check Bankident eligibility: Changed failure_reason property to an array of failure_reasons.
  • Credit cards guide: Updated "Credit card usage" section to indicate that customers can only make outgoing transfers to their reference accounts via reference account payouts, not SCTs.

2023-06-09

Changed

  • BKYC required documents: Updated the section with the required documents for more legal forms. This section currently only covers legal forms for Germany.
  • POST Create a business: Added more values for the legal_form field and explained the mapping in the legal form per country section in the onboarding requirements guide.

2023-06-08

Changed

  • 3DS guide: Condensed both the SMS OTP and the in-app method sections into one standard flow.

2023-06-06

note

We've updated the site to include a CRR logo to highlight that this site contains the API documentation for Solaris’ banking license products (CRR) and to distinguish it from the e-money license products (EMI) documentation website.

Added

Changed

  • [Cards API reference]: Changed the structure of the section by adding additional subsections:

    • Card creation & servicing: Includes different endpoints related to creating and servicing cards.
    • Cards tokenization: Includes the following services: Push Provisioning, Testing allowlists, and Visa tokens servicing.
    • Credit cards: Includes different endpoints related to creating and servicing credit cards.
  • Reservation endpoints: Updated the reservation endpoints to include both versions. The old version 2022-06-01 will be deprecated soon. Partners must switch to the new version. Please note that you've to set the api-version header to the version you want (e.g., 2022-07-18). If no version is specified in the header, the old version is returned.
  • [Strong Customer Authentication guide]: Changed the section when is SCA required to reflect the new regulations specifying that customers must login using SCA if more than 180 days instead of 90 days have elapsed since the last time the customer had been authenticated using SCA.
  • PATCH Set limit for credit card account: Fixed the endpoint's response to a single object instead of an array.

2023-06-02

Added

2023-05-25

Added

2023-05-24

Added

  • POST Create person: Added a note regarding the mobile_number field. This field is only used to pass the number to IDnow for the videoident KYC flow. Otherwise, you must use the mobile number endpoints to create and manage mobile numbers for your customers.

Changed

2023-05-19

Added

Changed

2023-05-12

Added

Changed

Removed

  • Webhook events: Removed the webhook event REPAYMENT_PLAN from the API reference and loan guides. Webhook event is deprecated.
  • Consumer Credit Lines API reference: Removed all endpoints related to terminating and blocking credit lines from the public API reference. Termination and blocking is handled internally by Solaris:

    • PATCH Terminate a credit line
    • POST Block a credit line
    • GET Retrieve a block
    • GET Index all blocks
    • DELETE Remove a block

2023-04-28

Changed

2023-04-26

Added

Changed

Removed

2023-04-25

Added

Changed

  • Consumer Loan guide: Updated the whole guide with language and stylistic changes to make the information more concise and reflect the updated API reference, and added new diagrams.

2023-04-21

Changed

Removed

2023-04-19

Added

Changed

  • Card transactions simulation API: The URL for the "Execute a test authorization" endpoint has changed.

    • Old URL: /v1/cards/{card_id}/simulator/transactions
    • New URL: /v1/cards/{card_id}/simulator/transactions/authorize
  • POST /v1/cards/{cardid}/virtualrequests (POST Create a secure view for card details): Changed the key requirement for the signature from restricted to unrestricted.
  • Card spending controls guide: Updated the introduction with more use cases for the feature, and added sample UIs to the guide.

2023-04-13

Added

Changed

2023-04-11

Added

Changed

2023-04-05

Added

Changed

  • Account Closure guide:

    • Added a hint about what information you must communicate to customers when informing them of account closure.
    • Updated the list of criteria that must be checked prior to automated account closure.
    • Clarified the legal vs. technical account closure date and when each occurs.
    • Added a hint about initiating ACRs with reasons other than CUSTOMER_WISH or for accounts with compliance blocks.
  • Business onboarding guide: Updated the whole guide with language and stylistic changes to make the information more concise, added a new dynamic onboarding overview diagram, made new reference links to the onboarding requirements guide for country-specific requirements.
  • Customer Due Diligence guide: Updated the EDD process flow to include the new questions & answers feature, which replaces the support ticket flow.
  • Onboarding requirements guide: Removed product availability diagram.

2023-03-28

Added

  • Onboarding requirements guide: Added a new guide in the Get Started section that gives an overview of the different onboarding requirements according to the product, customer type, and branch.

Changed

2023-03-23

Added

  • Webhooks guide: Added a new section that describes all headers that are included in a webhook notification.

Changed

  • Documentation for all webhook events has been migrated to OpenAPI format. Now all webhook event payloads are fully documented in the same way as the API specs, with descriptions for each header and property in a webhook notification.

2023-03-07

Added

Changed

  • PATCH Update a person: Updated the list of request parameters to indicate the properties that can actually be updated by this call.

2023-03-06

Added

  • New guide: Account Opening
  • New guide: Questions and Answers
  • Device Monitoring guide: Added an important hint that you may not create user activity without first collecting the customer's consent to device monitoring.
  • Fourthline guide: Added a new step that customers must sign the terms & conditions of Namirial before starting the QES flow.
  • Legal & compliance screens guide: Added a new screen for the self-declaration of politically exposed persons. Only relevant for customers opening an account in France, Italy, and Spain.
  • Onboarding guides: Added information about Tax identification numbers (TIN) in France, such as syntax rules and examples. Additionally, collecting tax IDs is optional for customers whose tax residency is in France.
  • B2B onboarding guides (Credit cards, Digital Banking, BKYC, Trade Finance, Business Fronting Factoring, Business Fronting): Added instructions about how to handle business legal representatives that are also legal entities.

Changed

Removed

  • Removed deprecated endpoints:

    • /v1/cards/{id}/limits/card_present
    • /v1/cards/{id}/limits/card_not_present

2023-02-22

Changed

  • Credit Cards guides: Information about creating the SDD manadate has changed. The first 6 digits of the SDD mandate number must be a partner-specific string agreed upon by you and Solaris during the implementation phase.
  • SEPA Instant Credit Transfers guide: Product flow diagram has been corrected to show that only the CLEARED status triggers the webhook notification.

2023-02-14

Added

2023-02-08

Changed

  • Brokerage guide:

    • Clarified the differences between the GET Simulate a Trade and GET Retrieve a Trade Price endpoints.
    • Updated the list of all values to reflect the current state of the API (e.g., removed all instances of min_amount and max_amount and replaced them with from_asset_min_amount and from_asset_max_amount).
    • Clarified that a value of null for from_asset_max_amount indicates that there is no limit for trading the from_asset.

2023-02-06

Added

Removed

  • [SEPA Instant Credit Transfer API]: Removed the GET /v1/accounts/{account_id}/transactions/sepa_instant_credit_transfers/{id} endpoint.

2023-01-30

Added

  • Business API: Added new values to the legal_form enum property:

    • PRIVATE_PERSON
    • ADOR
    • AMT
    • KDOR
    • STIFTUNGEN
    • SECOKG
    • AGCOKG
    • AT_AMT
    • AT_KOR
    • AT_STI
    • AT_GMBH
    • FR_AE
    • FR_EI
    • LU_SECA
    • LU_ASBL
    • LU_FON
    • LU_SP
    • NL_VEREN
    • NL_STICHT
    • PL_SA
    • PL_SPZOO
    • PL_SE
    • PL_SKA
    • PL_SPK
    • PL_SPJ
    • PL_SELF_EMPLOYED
    • PL_OTHER
    • CH_DE_AG
    • CH_FR_SA
    • CH_IT_SA
    • CH_DE_GMBH
    • CH_FR_SARL
    • CH_IT_SAGL
    • CH_SE
    • CH_DE_KOMAG
    • CH_FR_SCA
    • CH_IT_SACA
    • CH_DE_KG
    • CH_FR_SCM
    • CH_IT_SAC
    • CH_DE_KIG
    • CH_FR_SNC
    • CH_IT_SNC
    • CH_DE_EG
    • CH_FR_SS
    • CH_IT_SS
    • CH_SELF_EMPLOYED
    • CH_SOLE_PROPRIETORSHIP
    • TR_ADI_SIR
    • TR_AS
    • TR_LS
    • TR_KOM_STI
    • TR_KOLL_STI
    • TR_SELF_EMPLOYED
    • TR_SOLE_PROPRIETORSHIP
    • RO_SA
    • RO_SRL
    • RO_SCA
    • RO_SCS
    • RO_SNC
    • RO_SELF_EMPLOYED
    • RO_SOLE_PROPRIETORSHIP
    • RS_AD
    • RS_DOO
    • RS_KD
    • RS_OD
    • RS_SELF_EMPLOYED
    • RS_SOLE_PROPRIETORSHIP
    • HR_DD
    • HR_DOO
    • HR_JDOO
    • HR_KD
    • HR_JTD
    • HR_SELF_EMPLOYED
    • HR_SOLE_PROPRIETORSHIP
    • HR_ORTA
    • BG_AD
    • BG_OOD
    • BG_KDA
    • BG_KD
    • BG_SD
    • BG_SELF_EMPLOYED
    • BG_SOLE_PROPRIETORSHIP
    • SI_DD
    • SI_DOO
    • SI_KDD
    • SI_KD
    • SI_DNO
    • SI_SELF_EMPLOYED
    • SI_SOLE_PROPRIETORSHIP
    • HU_NYRT
    • HU_KFT
    • HU_BT
    • HU_KKT
    • HU_SOLE_PROPRIETORSHIP
    • HU_SELF_EMPLOYED
    • HU_ORTA

Removed

  • Business API: Removed hint from POST Create a beneficial owner for a business about mandatory tax information collection.

2023-01-27

Added

  • Postbox guide New document type FEE_SUMMARY_STATEMENT is now available via Postbox to customers in Spain.
  • API standards Added a link to Master Card merchant category codes reference manual.

Changed

  • Person onboarding guide The text for the account opening button has changed to include that it's subject to a charge.
  • Business onboarding guide Added a note that voting_share is not mandatory in case of fictitious beneficial owners.
  • Cards API Updated enum list for possible card types with a note that we don't list all possible values for the card type property, but only an indicative list.
  • 3DS guide Corrected the order of the authentication steps.

2023-01-24

Changed

  • [Cards API] Solaris now offers two endpoints for Encrypted PIN Change:

  • [Solaris Digital Assets - Brokerage API] Changed some properties for the TradingPrice resource:

    • precision was renamed to price_precision
    • min amount was changed to from_asset_min_amount
    • Added corresponding from_asset_max_amount property

2023-01-20

Added

  • [Legal & Compliance screens guide] Added screenshots of sample screens.
  • [Overdrafts API] New property added to GET Overdraft endpoints (all customer types): interest_accrued
  • [Solaris Digital Assets API] New attribute for TradingPair resources: max_amount
  • [Solaris Digital Assets API] New endpoint added: GET Simulate a Trade for a given Trading Pair

Changed

  • [Legal & Compliance screens guide]

    • Noted that you must also collect consent for Solaris' Terms & Conditions for all business legal representatives and authorized persons during signup.
    • Clarified that T&C consent during onboarding must be passed in the person or business resource, not the Terms and Conditions API.
  • [Solaris Digital Assets API] The GET Get the trade price of a Trading Pair endpoint no longer returns traded_to_amount or traded_from_amount properties.
  • [Solaris Digital Assets - Brokerage guide] Partners are now requested to use GET Simulate a Trade for a given Trading Pair for displaying the price of a Trade to an end user prior to conducting a Trade.

2023-01-13

Added

  • [API reference - Errors guide] Added a new section about API error handling and how to request support from Solaris.
  • [Strong Customer Authentication] Added more information about SCA login requirements.
  • [Webhooks guide] Added a new recommendation about generating a signature hash for content verification.

Changed

  • [Account management guide] Changed booking type CANCELLATION_CARD_TRANSACTION to CancellationCardTransaction.
  • [Mobile Number Management guide] Clarified that a verified mobile number is mandatory for all customers in all branches, not just Italy & Spain.

2023-01-11

Added

Changed

  • [Instant Card Top-Ups] Clarified some points in the guide:

    • The ACQUIRER_TOPUP_DECLINED webhook event will only trigger when Solaris declines a Top-Up transaction. If a customer's payment attempt fails, then the ACQUIRER_TOPUP_PAYMENT_FAILED webhook event will trigger.
    • The guide has been updated with instructions on how to cancel a Top-Up.
    • Clarified the definitions of each Top-Up status value in the appendix to reflect the above changes.
  • [Overdrafts] Updated the guides to indicate that Overdrafts monitoring is optional.
  • [SEPA Instant Credit Transfer] Clarified that the GET Check the reachability of an IBAN endpoint only checks the reachability of the recipient's bank, not of the individual IBAN.

Removed

  • [SEPA transfers API] Removed all GET endpoints for SEPA Direct Debit returns.
  • [Transactions API] Removed all Partner remittances endpoints.

2023-01-10

Added

2022-12-21

Added

2022-12-20

Changed

  • The company legal name was changed from "Solarisbank AG" to "Solaris SE."

2022-12-16

Added

  • [Business onboarding] Important: Collecting tax information from all natural persons associated with a business (e.g., legal representatives, beneficial owners, and any authorized person) is now mandatory in all branches and for any banking product, including Digital Banking, Cards and Lending products, such as Fronting and Fronting Factoring.
  • [Business onboarding] Important: Collecting valid addresses from all natural persons associated with a business (e.g., legal representatives, beneficial owners, and any authorized person) is now mandatory in all branches and for any banking product, including Digital Banking, Cards and Lending products, such as Fronting and Fronting Factoring.
  • [Cards API] Added new endpoint for testing card transactions: POST /v1/cards/{card_id}/simulator_transactions
  • [Webhooks] New cards webhook added: DELEGATE_SCA_CHALLENGE. This webhook notifies you when a customer declines the authentication process for a 3DS transaction.

Changed

2022-12-14

Added

Removed

2022-12-05

Added

Changed

  • Account Closure guide

    • Added a note to notify customers immediately about account closures initiated by Solaris.

2022-11-25

Added

Removed

2022-11-18

Added

Changed