The Partner API enables external systems like VULT to interact with OLIVE wallets. All requests require HMAC-SHA256 signature authentication.
Integration Partners
VULT
Mobile money integration for wallet funding
Banks
Bank transfer integrations
Custom
Custom partner integrations
Endpoints
Account Status
POST /partner/account-statusCheck if subscriber account existsTransaction History
POST /partner/transaction-historyGet partner’s transaction historyCash In
POST /partner/cashinCredit subscriber walletAuthentication
Partner API uses HMAC-SHA256 signature authentication instead of Bearer tokens.- Required Headers
- Signature Generation
- Full Request
| Header | Description |
|---|---|
X-Partner-ID | Your partner identifier (e.g., VULT) |
X-Signature | HMAC-SHA256 signature |
X-Timestamp | Unix timestamp of request |
Cash-In Flow
Response Examples
- Account Status
- Cash-In Success
- Transaction History
Error Handling
| Status | Code | Description |
|---|---|---|
| 400 | INVALID_REQUEST | Missing or invalid parameters |
| 401 | INVALID_SIGNATURE | HMAC signature verification failed |
| 401 | EXPIRED_TIMESTAMP | Timestamp older than 5 minutes |
| 404 | USER_NOT_FOUND | Subscriber not found |
| 500 | TRANSACTION_FAILED | Internal processing error |
Integration Checklist
Development
- Obtain partner ID and HMAC secret
- Implement signature generation
- Test with sandbox environment
- Handle all error responses
Production
- Request production credentials
- Set up webhook receivers
- Configure reconciliation process
- Enable monitoring/alerting