Getting started
Introduction
REST API under /wallet/api/v1. Integrators authenticate with client credentials issued in the dashboard, then create charges and look up receipts.
Base URL: https://gateway.tag.mw/wallet/api/v1
Old host
https://wallet.tag.mw/api/v1 still works (Caddy rewrites it onto the hub). Prefer the hub URL above.Getting started
Authentication
Exchange your client_id and client_secret for a short-lived Bearer JWT. Use that JWT on every subsequent request.
/auth/tokenClient credentialscurl -X POST https://gateway.tag.mw/wallet/api/v1/auth/token \
-H "Content-Type: application/json" \
-d '{
"client_id": "ck_xxxxxxxx",
"client_secret": "cs_xxxxxxxx"
}'Endpoints
Health
/healthPublic/readyPublicEndpoints
Operators
List the mobile-money networks you can charge against.
/operatorsClient JWTEndpoints
Charges
Create a charge. Mobile money requires mobile and operator_ref_id. Bank transfer needs only an amount.
/chargesClient JWTcurl -X POST https://gateway.tag.mw/wallet/api/v1/charges \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"channel": "mobile_money",
"mobile": "265991234567",
"operator_ref_id": "11111111-1111-1111-1111-111111111111",
"amount": "1500.00"
}'/charges/{reference}Client JWTEndpoints
Receipts
Public JSON, verify, and PDF for a successful payment share token.
/receipts/{token}Public/receipts/{token}/verifyPublic/receipts/{token}/pdfPublicEndpoints
Webhooks
PayChangu posts settlement events to this path. Configure the URL in PayChangu, not from the client API.
/webhooks/paychangu/PayChangu signatureAdmin API