Skip to main content

Quickstart

Step 1: Sign up​

Create your MALIPOPAY account at app.malipopay.co.tz.

Step 2: Get your API key​

In the dashboard, go to Settings → API Keys and copy your secret key.

Step 3: Make your first collection request​

curl -X POST https://core-staging.malipopay.co.tz/api/v1/payment/collection \
  -H "apiToken: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "currency": "TZS",
    "channel": "mpesa",
    "phone": "255712345678",
    "reference": "ORDER-001",
    "description": "Payment for Order #001"
  }'

Step 4: Handle the webhook​

Configure your webhook URL in the dashboard. MALIPOPAY will POST to your URL when the payment status changes:

{
  "event": "payment.completed",
  "reference": "ORDER-001",
  "amount": 50000,
  "currency": "TZS",
  "channel": "mpesa",
  "status": "COMPLETED",
  "transactionId": "MP250001234567"
}

Step 5: Go live​

Switch your base URL to https://core-prod.malipopay.co.tz/api/v1 and use your production API key.

Success
You're live!
Last updated on