Mobile Money

Use the API below to payout using mobile money.

Mobile Money Payout API

POST https://sandbox.dusupay.com/v1/payouts

Headers

Name	Type	Description
Content-Type*	String	application/json

Request Body

Name	Type	Description
api_key*	String	Obtained from merchant account setting
currency*	String	You can use your home currency when making requests. e.g USD You will receive your funds at the market rate into your merchant sub-account account.
amount*	Int/Double	2 decimal places allowed for double.
method*	String	MOBILE_MONEY
provider_id*	String	e.g airtel_ug,mtn_ug. Get the list of providers from Payment OptionsAPI
account_number*	String	Internationally formatted number
merchant_reference*	String	4 to 36 character
narration*	String	Use this to add a brief description or comment on the transaction. 4 to 64 character
account_name*	String	Customer's name
account_email	String	Used to email customer. Helps to easily lookup customer transactions.

202: Accepted

{
    "code": 202,
    "status": "accepted",
    "message": "Transaction Initiated",
    "data": {
        "id": 615666,
        "request_amount": 1500,
        "request_currency": "NGN",
        "account_amount": 13010.922,
        "account_currency": "UGX",
        "transaction_fee": 1500,
        "total_debit": 14510.922,
        "provider_id": "mtn_ug",
        "merchant_reference": "AdIVeSAde0LEsta50",
        "internal_reference": "DUSUPAY5FNZO5SL9ZK5B0T",
        "transaction_status": "PENDING",
        "transaction_type": "payout",
        "message": "Transaction Initiated"
    }
}

400: Bad Request

{
    "code": 400,
    "status": "error",
    "message": "Parameter 'account_number' should be a phone number in international format",
    "data": {}
}