Wallet-as-a-Service (WaaS)
Wallet-as-a-Service (WaaS) provides an API-driven abstraction for wallet creation, funding, payouts, and transaction tracking. WaaS handles:- Wallet lifecycle management
- Multi-currency balances
- Credit and debit transactions
- Wallet status controls
- Transaction reconciliation
Core Features & APIs
The Wallet API supports the following operations:- Customer Management
- Create and manage customer profiles
- Wallet Management
- Create wallets per customer and currency
- Retrieve wallet details and balances
- Update wallet status (active, frozen, deleted)
- Payment Methods
- Add supported payment methods to wallets
- Transactions
- Credit transactions (funding)
- Debit transactions (payouts)
- Transaction listing and retrieval
Base URL
Authentication
All API requests require authentication using an API key. HeaderTypical Merchant Flow
Customer Onboarding
- Create customer
- Complete KYC verification
- Create wallet
- Add payment method
Daily Operations
- Fund wallet (credit)
- Process payouts (debit)
- Retrieve balances
- Monitor transactions
Account Management
-
Freeze wallet
-
Delete wallet
Error Handling
| Code | Description |
|---|---|
| 400 | Invalid request parameters |
| 401 | Unauthorized (invalid API key) |
| 404 | Resource not found |
| 422 | Business rule validation failed |
| 500 | Internal server error |
Best Practices
- Complete customer KYC before wallet activation.
- Use idempotency keys for wallet and transaction creation.
- Persist transaction IDs for reconciliation.
- Keep wallet status synchronized with internal user state.
- Use sandbox mode before production deployment.