12-Jun-2026
LipaPay Ver2 / Sandbox API reference
EN sandbox@lipapay.test Sign in LP

LipaPay Ver2 — sandbox API

All paths below are served from this sandbox host only. Request and response shapes mirror the production LipaPay Ver2 API; only the base URL and simulated settlement differ.

Base: http://sandbox.lipapay.co.tz/api/sandbox Sanctum bearer on protected routes Engine + portal + secure checkout
POST /api/sandbox/login

Login

Auth: None

Issue Sanctum bearer token (same JSON as portal.lipapay.co.tz/api/login).

POST /api/sandbox/logout

Logout

Auth: Bearer token

Revoke current Sanctum token.

POST /api/sandbox/initiate-payment/mno/

Initiate MNO

Auth: Bearer token

Create mobile collection request.

POST /api/sandbox/initiate-payment/bank/

Initiate Bank

Auth: Bearer token

Create bank collection request (CRDB-style responses).

POST /api/sandbox/transaction/status

Transaction Status

Auth: Bearer token

Lookup transaction by ref_id.

POST /api/sandbox/initiate-secure-payment

Secure Payment

Auth: None

Return hosted checkout payment_url.

POST /api/sandbox/mno/

Portal MNO

Auth: Payment token

Hosted checkout MNO (token + phone).

POST /api/sandbox/portal-session

Portal Session

Auth: Payment token

Card session for secure checkout.

GET|POST /api/sandbox/callback

Engine Callback

Auth: Engine

Settlement callback (LipaPay engine payload).

POST /api/sandbox/pay_mobile

Engine pay_mobile

Auth: Optional API key

Engine-compatible pay_mobile payload.

POST /api/sandbox/merchant/test-azam

Azam test

Auth: None

Sample JWT/Hash for Azam integration tests.

Production contract mapping

When you go live, swap /api/sandbox for your production LipaPay host — field names and JSON structure stay the same.

Sandbox path Production equivalent
/api/sandbox/login /api/login (LipaPay_Ver2)
/api/sandbox/initiate-payment/mno/ /api/initiate-payment/mno/ (LipaPay_Ver2)
/api/sandbox/transaction/status /api/transaction/status (LipaPay_Ver2)

Run LipaPay sandbox calls

Interactive forms for login, pay_mobile, MNO, bank, status, and secure checkout.

Sign in for testing lab