Direct Mobile Money Payment

Mobile Money Collection API

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

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.
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	Provide an internationally formatted number e.g 256777111777
merchant_reference*	String	The UNIQUE reference for this transaction generated by your system. A unique string value should be sent for every attempt. 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	Helps to easily lookup customer transactions.
account_email	String	Used to email customer. Helps to easily lookup customer transactions.
voucher	String	extra data field required only for GhanaMobileMoney-Vodafone
user_id*	String	This uniquely identifies the client on your system. A client is expected to have the same identifier for every transaction made by them. This is to allow for fraud detection.

202: Accepted

{
    "code": 202,
    "status": "accepted",
    "message": "Transaction Initiated",
    "data": {
        "id": 615615,
        "request_amount": 7,
        "request_currency": "USD",
        "account_amount": 26632.8249,
        "account_currency": "UGX",
        "transaction_fee": 1038.6802,
        "total_credit": 25594.1447,
        "provider_id": "mtn_ug",
        "merchant_reference": "xxxxxxxx7",
        "internal_reference": "DUSUPAY5FNZFXBL9WKQMTI",
        "payment_url": "",
        "transaction_status": "PENDING",
        "transaction_type": "collection",
        "message": "Transaction Initiated",
        "instructions": [
            {
                "step_no": "1",
                "description": "Ensure that you have sufficient balance on your MTN Mobile Money account"
            },
            {
                "step_no": "2",
                "description": "Approve the payment request sent to your phone"
            }
        ],
        "customer_charged": false
    }
}

422: Unprocessable Entity

{
    "code": 422,
    "status": "error",
    "message": "Transaction with merchant reference 'xxxxxxxxx1' already exists. Provide a unique reference for every request",
    "data": {}
}