Solaris adheres to specific international standards to ensure data consistency and regulatory compliance.
| Standard | Description | Reference | Example |
|---|---|---|---|
| Country Codes | ISO 3166-1 alpha-2 | Wikipedia | DE, FR, ES |
| Currency Codes | ISO 4217 | Wikipedia | EUR |
| State Codes | ISO 3166-2 (Germany) | Wikipedia | BE (Berlin) |
| Dates & Times | ISO 8601 | Wikipedia | 2023-12-31T23:59:59Z |
| Phone Numbers | E.164 | Wikipedia | +491701234567 |
The Solaris API uses UTF-8 encoding.
For all fields related to Customer Data (Names, Addresses), Solaris only accepts UTF-8 Latin characters. Submitting other character sets (e.g., Cyrillic, Kanji) will cause the KYC flow to fail.
Solaris does not use floating-point numbers for financial amounts. Instead, all monetary values (amount, balance, fee, charge) use a structured Money Object.
| Property | Type | Description |
|---|---|---|
value | integer | The amount in the smallest unit (e.g., Cents). |
unit | string | The unit of currency. Currently only cents. |
currency | string | The currency code. Currently only EUR. |
precision | integer | (Optional) The decimal precision of the value. |
To represent €10.00, you send a value of 1000 cents.
{
"amount": {
"value": 1000,
"unit": "cents",
"currency": "EUR",
"precision": 2
}
}The European Payments Council (EPC) limits the characters allowed in SEPA transactions (EPC217-08). Solaris enforces this restricted set on the following fields:
- Credit Transfers:
recipient_name,end_to_end_id,description. - Direct Debits:
end_to_end_id,description,mandate.reference,mandate.debtor_name.
a b c d e f g h i j k l m n o p q r s t u v w x y z
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
0 1 2 3 4 5 6 7 8 9
/ - ? : ( ) . , ' +- No leading spaces.
- Slashes (
/):- Cannot start or end with a slash.
- Cannot contain double slashes (
//).
- Extended Characters: Solaris automatically converts extended Latin characters (e.g.,
ö$\rightarrow$o:) according to EPC guidelines.
Solaris must escape specific characters internally. This affects the character count limit.
| Character | Escaped As | Count Impact |
|---|---|---|
' (Single Quote) | ' | Counts as 6 characters |
Solaris uses standard Merchant Category Codes for transaction classification.
Return codes for SEPA R-transactions (Refunds, Returns, Rejects) follow the EPC173-14 standard.