Quickstart
Integrate mobile money collections and disbursements with Selcom-compatible digest auth.
1. Create a sandbox account
Sign up for instant TEST keys — no approval required.
2. API hosts
- Sandbox:
https://sandbox.api.lipachap.com(TEST keys) - Live:
https://api.lipachap.com(LIVE keys, requires approval)
3. Authorization
Authorization: GATEWAY <base64(apiKey:sha256(secret + path + rawBody))>Compute SHA-256 over the concatenation of your API secret, request path, and raw JSON body. Prefix with your API key and base64-encode.
4. Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v1/walletcashin/process | Member deposit (CASHIN) |
| POST | /v1/gateway/cashin | Withdrawal / disbursement (CASHOUT) |
| POST | /v1/checkout/status | Transaction status lookup |
5. Webhooks
Configure callback URLs in the merchant dashboard. Events: payment.success, payment.failed.
Verify HMAC signatures using headers X-Gateway-Signature, X-Gateway-Timestamp, X-Gateway-Nonce.