Skip to main content

Send Payment

This api endpoint sends payment to a mobile money subscriber.

HTTP Request​

POST​
https://payments.munopay.com/api/v1/withdraw

Arguments​

Parameter Type Required Description
account_number string Required The account number from which the funds will be withdrawn.
phone string Required The recipient’s mobile money account number to which the money will be sent. Should be internationally formatted, e.g., 256701345678.
amount decimal Required Amount to be sent to the recipient’s mobile money account.
reference string Required A unique generated string to identify your request. Minimum 8 and maximum 36 characters.
description string Optional A description for the request.
email string Optional The email of the recipient or customer.
names string Optional The full name of the recipient or customer.

Sample send payment request​


curl "https://payments.munopay.com/api/v1/withdraw" \
   -X POST \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer <--Your API Secret Key-->" \
   -d '{ 
        "account_number": "0100987654321",
        "reference": "tx_9f7d4b1c2a56",
        "phone": "256771234567",
        "amount": 1000.00,
        "description": "Send Payment to John Doe.",
        "email": "customer@email.com",
        "names": "John Doe"
    }'

Sample response.​


{
    "status": "success",
    "message": "Send payment in progress",
    "phone": "256771234567",
    "amount": "1000.00",
    "payment_method": "MTN Mobile Money",
    "transaction_id": "MPYRXN3V4372DGPTX",
    "reference_id": "tx_9f7d4b1c2a56"
}