Skip to main content

Request Payment

This api endpoint requests for a payment from a mobile money subscriber.

HTTP Request​

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

Arguments​

Parameter Type Required Description
account_number string Required Merchant’s unique account number provided after registration.
phone string Required Mobile money subscriber’s phone number from which to deduct payment. Should be internationally formatted, e.g., 256701345678.
amount decimal Required Amount to be deducted from the mobile money subscriber’s account.
reference string Required A unique generated string to identify your request. A minimum of 8 and maximum of 36 characters is allowed.
description string Optional A description for the request.
email string Optional Customer’s email address for transaction notifications.
names string Optional Full name of the customer making the payment.

Sample payment request​


curl "https://payments.munopay.com/api/v1/deposit" \
   -X POST \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer <--Your API Secret Key-->" \
   -d '{ 
        "account_number": "0100123456789",
        "reference": "52750b30ffbc7de3b36",
        "phone": "256701345672",
        "amount": 500.00,
        "description": "Payment Request.",
        "email": "customer@email.com",
        "names": "John Doe"
    }'

Sample response.​


{
    "status": "success",
    "message": "Payment request in progress",
    "phone": "256742123456",
    "amount": "1000.00",
    "payment_method": "Airtel Money",
    "transaction_id": "MPY8DMT63924QDCTX",
    "reference_id": "tx_68d7beu32154d"
}