The official OpenAPI 3.0 specification for the MaliPoPay payment platform.
MaliPoPay provides web and mobile payment solutions for businesses in Tanzania -- Mobile Money (M-Pesa, Tigo Pesa, Airtel Money, Halo Pesa), Bank Transfer, USSD, Card, and Lipa Number.
| File | Description |
|---|---|
openapi.yaml |
Main OpenAPI 3.0 specification (YAML) |
schemas/ |
Shared schema components (reserved for future splitting) |
examples/ |
Request/response examples (reserved) |
scripts/validate.sh |
Lint the spec with Spectral |
Open openapi.yaml in any OpenAPI-compatible tool:
- Swagger Editor -- paste or import the file
- Stoplight Studio
- Redocly
./scripts/validate.shOr manually:
npx @stoplight/spectral-cli lint openapi.yaml| Environment | Base URL |
|---|---|
| Production | https://core-prod.malipopay.co.tz |
| UAT / Sandbox | https://core-uat.malipopay.co.tz |
All API requests require a project-level API key passed in the apiToken header:
curl -H "apiToken: your-api-key" \
https://core-prod.malipopay.co.tz/api/v1/paymentGet your API key from the MaliPoPay dashboard under Settings > API Keys.
| Language | Package | Repository |
|---|---|---|
| Node.js | malipopay-node |
github.com/nickswalker21/malipopay-node |
| Python | malipopay-python |
github.com/nickswalker21/malipopay-python |
Collect payments via Mobile Money push (M-Pesa, Tigo Pesa, Airtel Money), disburse funds, verify transaction status, and generate reports.
Create and manage customer records with phone number, email, and address details.
Create invoices with line items, tax calculations, and TRA (Tanzania Revenue Authority) fiscal receipt integration.
Manage your product and service catalogue with pricing, categories, and tax settings.
Send single, bulk, and scheduled SMS messages to customers.
The complete API specification with all 120+ endpoints (including accounting, USSD, TRA, notifications, and more) is available in the malipopay-docs repository at public/openapi/openapi.json.
MIT -- see LICENSE.
Copyright 2026 Lockwood Technology Ltd.