Sipay Business API empowers partners to build seamless financial integrations into their platforms.
This guide helps you understand authentication, key services, and request/response schemas.
🔐 Authentication#
All API requests require a valid access token.
Use the POST /connect/token endpoint to retrieve one using your client_id and client_secret.Example Request#
🌐 Environments#
| Environment | URL |
|---|
| UAT | https://idsuat.walletgate.iO |
| UAT | https://stsapiuat.walletgate.io |
You’ll get the token from 'https://idsuat.walletgate.io', and all API operations will go through https://stsapiuat.walletgate.io.
We’ll share the exact production domain details when the live environment setup begins.
📦 Core Services#
Wallet Management: Create, list and get wallet details
Money Transfers: Send money to IBANs, users, and internal accounts
Transaction Data: Access logs and filter activity with fine-grained control
| Header | Description |
|---|
Authorization | Bearer token |
Content-Type | application/json |
x-client-id | Your platform-specific client key |
🚨 Error Handling Example#
| Code | Message |
|---|
| 100 | Success |
| 300 | Wallet not found or invalid |
| 301 | Duplicate ext_transaction_id |
| 503 | IBAN and name mismatch |
| 311 | Insufficient wallet balance |
Next Steps#
Please refer to the Endpoints section for full API definitions.