Financial Operations
Post-activation APIs for balances, beneficiaries, consents, and transfers
Financial Operations
Complete API reference for post-activation financial operations including wallet management, beneficiaries, transfers, and payments.
Prerequisites
Before accessing financial operations:
- Customer account ACTIVATED (individual or organization)
- Wallet status = ACTIVE
- Valid JWT token from session
- Sufficient wallet balance (for outgoing transfers)
Core journey (happy path)
| Step | API | Purpose |
|---|---|---|
| 1 | GET /fintrans/{accountId}/balance | Confirm available funds |
| 2 | POST /fintrans/{accountId}/beneficiaries | Register a recipient |
| 3 | POST /fintrans/{accountId}/payment-consents/types/{operationType} | Create authorization (if required) |
| 4 | POST /fintrans/{accountId}/types/{operationType}/prepare | Validate and reserve funds |
| 5 | POST /fintrans/{accountId}/types/{operationType}/execute | Execute the prepared operation |
| 6 | GET /fintrans/{accountId}/orders/{orderId} | Monitor status |
Endpoints
Beneficiaries
Add beneficiary (account)
POST /api/v2.1/fintrans/{accountId}/beneficiaries
Get beneficiaries for wallet
POST /api/v2.1/wallets/{walletId}/beneficiaries