Mobile Money

Discover how to send funds directly from your available balance to a mobile money account.

🚧

NOTICE

This endpoint only support Airtel Money if your planning on sending to both Airtel Money and TNM Mpamba use the bank methond it support both Airtel Money and TNM Mpamba.

Mobile money transfers are different from bank transfers because they use different systems, but both send money instantly, so the recipient gets it right away.

Mobile Money Sample Request

curl --request POST \
     --url https://api.paychangu.com/mobile-money/payments/initialize \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "mobile_money_operator_ref_id": "20be6c20-adeb-4b5b-a7ba-0769820df4fb",
  "mobile": "0990000000",
  "amount": "1000",
  "charge_id": "PC-64FU65435"
}
'

🗒️

Sample in other languages check here.

Handling the Response

After initiating a transfer, you will receive a response like this:

"status": "success",
  "message": "Payment initiated successfully.",
  "data": {
    "amount": 1000,
    "charge_id": "PC-64FU65435",
    "ref_id": "95652259752",
    "trans_id": "f28e10a6-5d71-4499-9ac3-fdce917fae98",
    "first_name": null,
    "last_name": null,
    "email": null,
    "status": "pending",
    "mobile": "+265990xxxx00",
    "attempts": 2,
    "currency": "MWK",
    "mode": "live",
    "created_at": "2024-06-15T00:21:33.000000Z",
    "completed_at": null,
    "mobile_money": {
      "name": "Airtel Money",
      "ref_id": "20be6c20-adeb-4b5b-a7ba-0769820df4fb",
      "country": "Malawi"
    }
  }
}

There are some important details here:

status.data.status is the status of the transfer. status.data.charge_id is the ID of the transfer. You can use this ID to fetch details about this transfer later.