Payment Providers

Payment providers identify which provider or entity a transaction request is meant to be performed against.

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.

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

Headers
Request
Response
Sample Response (Live)
Sample Response (Sandbox)
Headers

Request Headers

Header

Value

Required

secret-key

Merchant account secret-key

YES

Content-Type

application/json

YES

Request

URL Request Parameters

Parameter Name

Type

Description

Required

api_key

string

Merchant Public Key

YES

transaction_type

string

Use any of the following;

  • COLLECTION

  • PAYOUT

YES

method

string

Use as described here

  • MOBILE_MONEY

  • CARD

  • BANK

  • CRYPTO

YES

country

string

ISO-2 country code e.g UG

Use available countries here

YES

Response

Response body

Parameter

Type

Description

id

string

This is the provider_id. Use this wherever a provider_id is required. This should not be displayed to the customer

name

string

This is the name of the provider_id returned. This can be displayed to the customer.

Sample Response (Live)
// GET https://api.dusupay.com/v1/payment-options/collection/mobile_money/ug?api_key={{api_key}}
{
"code": 200,
"status": "success",
"message": "Request completed successfully.",
"data": [
{
"id": "mtn_ug",
"name": "MTN Mobile Money"
},
{
"id": "airtel_ug",
"name": "Airtel Money"
}
]
}
Sample Response (Sandbox)
// GET https://sandbox.dusupay.com/v1/payment-options/collection/mobile_money/ug?api_key={{api_key}}
{
"code": 200,
"status": "success",
"message": "Request completed successfully.",
"data": [
{
"id": "mtn_ug",
"name": "MTN Mobile Money",
"transaction_currency": "UGX",
"sandbox_test_accounts": {
"success": "256777000123",
"failure": "256777000456"
}
},
{
"id": "airtel_ug",
"name": "Airtel Money",
"transaction_currency": "UGX",
"sandbox_test_accounts": {
"success": "256752000123",
"failure": "256752000456"
}
}
]
}