Getting started
Introduction
Welcome to the Eurosia Systems API. Build crypto-to-fiat payment flows, wallet custody, KYC/AML compliance, and real-time settlement into your product using our REST API. All requests use JSON over HTTPS.
Terminology
| Term | Explanation |
|---|---|
| Partner | You — the platform integrating Eurosia Systems infrastructure. |
| User | An end-user of your platform who holds a custody wallet. |
| Wallet | MPC-secured custody account holding crypto via Fireblocks. |
| Payment session | A single crypto→fiat payment intent at POS or QR scan. |
| Swap | Real-time conversion of crypto to EUR/USD at locked spot rate. |
| Settlement | Daily consolidated payout to your registered IBAN. |
| KYC | Identity verification required before live payment sessions. |
| MCC | Merchant Category Code — used to block high-risk categories. |
Base URLs
sandboxhttps://api-sandbox.eurosiasystems.com/v1
livehttps://api.eurosiasystems.com/v1
HTTP response codes
| Code | Meaning | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 201 | Created | Resource created successfully. |
| 400 | Bad request | Missing or invalid parameters. |
| 401 | Unauthorized | Invalid or missing API key. |
| 404 | Not found | Resource does not exist. |
| 409 | Conflict | Concurrent request — retry after brief delay. |
| 422 | Unprocessable | Swap failure, KYC reject, or compliance block. |
| 429 | Rate limited | Too many requests — see rate limits. |
| 50x | Server error | Temporary issue on our end. |