Built for Developers
A clean, RESTful API that gets you accepting payments in Tanzania in under 5 minutes.
5-Minute Integration
Start collecting payments with just a few lines of code
curl --location 'https://core-prod.malipopay.co.tz/api/v1/payment/collection' \
--header 'apiToken: mp_sk_prod_xxxxx' \
--header 'Content-Type: application/json' \
--data '{
"reference": "ORDER-001",
"description": "Payment for order",
"amount": 2000,
"phoneNumber": "255687123214",
"amountType": "FULL"
}'{
"success": true,
"message": "Payment submitted successful!",
"data": {
"merchantAccountId": "Your Business Name",
"mode": "CHARGE",
"amountType": "FULL",
"reference": "ML27154",
"amount": 2000,
"paidAmount": 0,
"transactionFee": 0,
"customer": {
"phoneNumber": "255687123214",
"firstname": "JOHN",
"lastname": "DOE",
"mno": "Airtel"
},
"description": "Payment for order",
"currency": "TZS",
"status": "PROCESSING",
"id": "69c3c5129be6ef92b6242497",
"createdAt": "2026-03-25T11:20:50.933Z",
"updatedAt": "2026-03-25T11:20:51.971Z"
}
}Documentation & Resources
Everything you need to build, test, and launch
Quickstart
Collect your first payment in 5 minutes with our step-by-step quickstart guide.
API Reference
Complete REST API documentation with request/response examples for every endpoint.
Webhooks
Real-time payment notifications delivered to your server with retry logic.
Going Live
Step-by-step checklist to move from sandbox to production.
Developer-Friendly Features
Built with the developer experience in mind
Sandbox Environment
Test your integration with simulated payments before going live. No real money involved.
Webhook Notifications
Get real-time payment status updates delivered directly to your server via HTTPS.
Comprehensive Error Handling
Clear error codes and messages so you can handle every edge case gracefully.