Release notes
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
- Card spending controls: Added new scope:
PARTNER_CARDHOLDERS
- Postbox: Added new
document_type
value:SINGLE_FEE_STATEMENT
- Terms and Conditions consent log: Added new request/response property:
document_name
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
- Legal & compliance screens guide Updated the legal text for the terms and conditions screen.
- Legal & compliance screens guide Updated the legal text for the customer information screen.
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
-
Card creation & servicing guide: Added new transaction declined reasons:
LIST_CONTROL
SPENDING_LIMIT
- Cards visa tokenization API: Added new filter:
visa_token_number
2023-02-08
Changed
-
- 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
andmax_amount
and replaced them withfrom_asset_min_amount
andfrom_asset_max_amount
). - Clarified that a value of
null
forfrom_asset_max_amount
indicates that there is no limit for trading thefrom_asset
.
2023-02-06
Added
-
Cards API: New API endpoints:
- Credit Cards API: Added new field
repayment_type_switch_available_date
to the credit card application resource. -
Webhooks: Added new field
account_id
to the following webhooks:
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:
- POST Change PIN with Change Request: Changes the card's PIN without a Change Request. Note that this endpoint includes Device Monitoring.
- POST Change PIN: Changes the card's PIN using a Change Request.
-
[Solaris Digital Assets - Brokerage API] Changed some properties for the TradingPrice resource:
precision
was renamed toprice_precision
min
amount was changed tofrom_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
ortraded_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
toCancellationCardTransaction
. - [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
- [Business fronting API] Added property
factoring_fee
in the POST Create business fronting loan or fronting factoring application endpoint. - [Business fronting API] Added value
VAT_TRANSFER
for thetag
property in the POST Trigger a partial loan payout for a business fronting factoring endpoint. - [Card spending controls] Added information about the PARTNER_CARDS_DEFAULT scope for card spending limit controls.
- [Instant Card Top-Ups] New webhook event added: ACQUIRER_TOPUP_PAYMENT_FAILED.
- [Instant Card Top-Ups API] New endpoint added: POST Cancel a Top-Up
- [Overdrafts] New webhook event added: OVERDRAFT_LIMIT_CHANGE.
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 theACQUIRER_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.
- The
- [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
-
New guide and API reference for SEPA Instant Credit Transfers are added:
- Customer Due Diligence guide CDD process is now also mandatory for B2B customers. Added the B2B flow for CDD monitoring and validation, as well as process diagrams.
- Video identification guide. Added preconditions that must be met for video identification integration.
- Account Closure guide and Splitpay guides. Added a note about Splitpay termination in case of account closure to the account closure guide and the Splitpay guides.
- Card spending controls guide. Added a note about the internal scope
PARTNER_CARDS_DEFAULT
, which can only be set by Solaris.
2022-12-21
Added
-
[SDA Custody - Account management] Added an example for creating an Account of type
TOKEN
.Removed
- [Device monitoring] Removed POST Create a person from the list of actions that require device monitoring. Removed the
device_data
property from the API docs for this endpoint.
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
- [Loans API] Corrected the attribute type of installment
number
tostring
in GET Retrieve a loan schedule - [Webhooks] Corrected the example payload for the CARD_AUTHORIZATION_DECLINE_V2 webhook.
2022-12-14
Added
- [AML update guide] Added a table of required data points to confirm for each branch (i.e., not just DE).
- [Cards push provisioning] Added
400
response example to all cards push provisioning API endpoints. - [Clearing transactions] Added
initiator_reference
property to all clearing transaction API endpoints. -
[Device monitoring]
- Updated the device monitoring guide with information about how a customer may withdraw their GDPR cookie consent.
- Added a new API endpoint: PATCH Update user consent for device monitoring.
Removed
- POST Create a card: Removed
card_configuration_id
property.
2022-12-05
Added
- Authentication guides Created a new section under Guides to group all authentication guides together and explain how they are related.
- Moved Device binding and Strong Customer Authentication guides to the new authentication section.
- [Cards creation and servicing] Added new appendix describing card status flows.
Changed
-
- Added a note to notify customers immediately about account closures initiated by Solaris.
2022-11-25
Added
-
New consumer overdraft API endpoints:
Removed
- [Cards creation and servicing] Removed
DUPLICATE_TRASACTION_TYPE
from the list of transaction decline reasons (V2).
2022-11-18
Added
- [Account management guide] Added SepaInstantCreditTransfer to the list of booking types.
- [Fourthline guide] Added Proof of Address requirement.
- [Fourthline guide] Added missing upload a QES document step.
- [Business/Consumer/Freelancer Overdrafts guides] Added a note about overdraft information included on statements of account & bank statements.
Changed
- [Cards servicing guide] Updated the transaction decline reasons table (V2) with the correct values.
- [Encrypted PIN change guide] Clarified the need to use the restricted key when requesting a PIN change.
- [SEPA Direct Debit guide] Marked the SEPA Direct Debit for Business/Freelancers product as legacy.
- PATCH /persons/{person_id}/identifications/{id}/authorize: Removed "Bankident only" from the title and removed note about the IdentHub SDK.
- PATCH /persons/{person_id}/identifications/{id}/confirm: Removed "Bankident only" from the title and removed note about the IdentHub SDK.