LipaAirtime

Airtime purchase and wallet recharge flow aligned to Lipa_Airtime source behavior.

Sandbox base: /api/sandbox/airtime Mirrors Lipa_Airtime contract

1 Register or login under /api/sandbox/airtime to obtain a bearer token.
2 Debit wallet for airtime with POST /api/sandbox/airtime/customer/payments.
3 Top up wallet with POST /api/sandbox/airtime/customer/balancerecharge and POST /api/sandbox/airtime/callbackUrl.

Endpoints

POST /api/sandbox/airtime/register

Auth: None

Create sandbox airtime merchant account.

POST /api/sandbox/airtime/login

Auth: None

Authenticate and return bearer token.

POST /api/sandbox/airtime/customer/payments

Auth: Bearer token

Send airtime from wallet balance.

POST /api/sandbox/airtime/customer/balancerecharge

Auth: Bearer token

Initiate wallet top-up and receive controlNumber.

POST /api/sandbox/airtime/callbackUrl

Auth: None

Confirm recharge by controlNumber.

GET /api/sandbox/airtime/user

Auth: Bearer token

Return authenticated airtime user.