Integrator reference

Wallet Gateway API

Collect mobile-money and bank-transfer payments for your clients. This page covers the public client API — not the admin dashboard.

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.

POST/auth/tokenClient credentials
POST /auth/token
curl -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

GET/healthPublic
GET/readyPublic

Endpoints

Operators

List the mobile-money networks you can charge against.

GET/operatorsClient JWT

Endpoints

Charges

Create a charge. Mobile money requires mobile and operator_ref_id. Bank transfer needs only an amount.

POST/chargesClient JWT
POST /charges
curl -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"
  }'
GET/charges/{reference}Client JWT

Endpoints

Receipts

Public JSON, verify, and PDF for a successful payment share token.

GET/receipts/{token}Public
GET/receipts/{token}/verifyPublic
GET/receipts/{token}/pdfPublic

Endpoints

Webhooks

PayChangu posts settlement events to this path. Configure the URL in PayChangu, not from the client API.

POST/webhooks/paychangu/PayChangu signature

Admin API

Client credentials cannot list or rotate webhooks. Platform operators manage those in the dashboard.