Direct Mobile Money Payment

Mobile Money Collection API

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

Headers

NameTypeDescription

Content-Type*

String

application/json

Request Body

NameTypeDescription

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.

{
    "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
    }
}

Last updated