Payment Options

Before any transaction request is performed, it's recommended that the list of payment options is retrieved to obtain some of the required parameters.

Payment Options API

GET https://sandbox.dusupay.com/v1/payment-options/{transaction_type}/{method}/{country}?api_key={api_key}

Path Parameters

Name	Type	Description
transaction_type*	String	Checkout transaction types
method*	String	Checkout transaction methods
country*	String	Checkout supported countries

Query Parameters

Name	Type	Description
api_key*	String	Merchant Public Key

Headers

Name	Type	Description
secret-key*	String	secret-key
Content-Type*	String	application/json

200: OK

{
    "code": 200,
    "status": "success",
    "message": "Request completed successfully.",
    "data": [
        {
            "id": "mtn_ug",
            "name": "MTN Mobile Money",
            "transaction_currency": "UGX",
            "min_amount": 3000,
            "max_amount": 5000000,
            "available": true,
            "sandbox_test_accounts": {
                "success": "256777000123",
                "failure": "256777000456"
            }
        },
        {
            "id": "airtel_ug",
            "name": "Airtel Money",
            "transaction_currency": "UGX",
            "min_amount": 3000,
            "max_amount": 5000000,
            "available": true,
            "sandbox_test_accounts": {
                "success": "256752000123",
                "failure": "256752000456"
            }
        }
    ]
}

404: Not Found

{
    "code": 404,
    "status": "error",
    "message": "There are no options found for bank payouts in CM",
    "data": []
}

401: Unauthorized

{
    "code": 401,
    "status": "error",
    "message": "Unauthorized API access. Secret Key header {secret-key} is required",
    "data": {}
}

The API description below shows how the list of payment options can be obtained. The request requires that the merchant filters by country and transaction type to get the appropriate list of the payment options.

When you request providers using the sandbox API, we will include the test account that can be used to test both successful or failure of transactions which ensures that your integration works as expected when you switch to the Live API.

Transaction Types

Collection

Collections credit your account. Checkout the list of countries and their respective collection methods we support here.

Payout

Payouts debit your account and require you to have enough funds on you account before you proceed. Checkout the list of countries and their respective payout methods we support here.

Transaction Methods

Below are the transaction methods supported on this platform

Method	Description
Mobile Money(MOBILE_MONEY)	Requires an internationally formatted number.
Card	Either Hosted Payment Page or Direct Card Payment
Bank	Requires redirect URL
Crypto	checkout crypto payment providers