Dusupay
Search…
Post Payout Request
This function is used to initiate a payout request after the customer has provided information about where they want their funds sent as a withdraw or payment.

Sandbox Payout API

1
POST https://sandbox.dusupay.com/v1/payouts
Copied!
Headers
Request
Response
Sample Request
Sample Response
Sample IPN

Request Headers

Header
Value
Required
Content-Type
application/json
YES

Request Body

Parameter
Type
Description
Required
api_key
string
Obtained from merchant account settings
YES
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.
YES
amount
int/double
2 decimal places allowed for double.
YES
method
string
MOBILE_MONEY, BANK
YES
provider_id
string
e.g airtel_ug, mtn_ug. Get the list of providers from the Payment Providers API
YES
account_number
string
Internationally formatted number required if the method is MOBILE_MONEY For European, UK, Germany bank payouts, set account_number to contain the IBAN
YES
account_name
string
The name of the customer’s account
YES
account_email
string
The email address of the customer
NO
merchant_reference
string
This is a unique transaction reference generated by your system. You can try using UUID version 4.
YES,
4 to 36 character
narration
string
Use this to add a brief description or comment on the transaction.
YES, 4 to 64 characters
extra_params
Object
This field is mainly used to pass data that applies to specific payout methods or providers that follow below
NO

Extra Parameters

  • Different countries require different extra information to send money to customer’s accounts correctly.
  • Below are some of the fields per country that are required to be included in the extra_params the field when making a payout request.
Method
Extra fields
Description
Uganda - BANK
bank_code
The Bank code of Ugandan Bank
Kenya - BANK
bank_code
The Bank code of Kenyan Bank
Tanzania - BANK
bank_code
The Bank code of Tanzanian Bank
Nigeria - BANK
bank_code
The Bank code of Nigeria Bank
Ghana - BANK
bank_code
The Bank code of Ghanaian Bank
branch_code
The Branch Code of Ghanaian Bank. Required for GHS An API to get Branch Codes can be found here.
USA - BANK
routing_number
Bank Routing number
swift_code
Bank Swift code
bank_name
Bank Name e.g (BANK OF AMERICA)
beneficiary_address
e.g San Francisco, 4 Newton
Europe - BANK
bank_code
Bank code provided by the payment options API e.g bank_fr (for France), bank_de (for Germany)
routing_number
The swift code can be used here
swift_code
Bank Swift code
postal_code
Beneficiary postal code e.g 80489
street_number
e.g 31
street_name
e.g Handelsbank Elsenheimer St
city
e.g Munchen
bank_name
Bank Name e.g (LLOYDS BANK)
U.K - BANK
routing_number
The swift code can be used here
swift_code
Bank Swift code
postal_code
Beneficiary postal code e.g 80489
street_number
e.g 31
street_name
e.g Handelsbank Elsenheimer St
city
e.g Munchen
bank_name
Bank Name e.g (LLOYDS BANK)
bank_code
Bank code provided by the payment options API e.g bank_at (for Australia), bank_be (for Belgium)

Response body

Parameters
Type
Description
request_amount
double
Amount requested for collection
request_currency
string
The currency of the requested amount
account_amount
double
The converted amount from request_currency to account_currency at market rate.
account_currency
string
The sub-account/wallet currency in your merchant account where the amount paid by the customer will be deposited. The currency of the amount paid by the customer is determined by the provider_id used to pay.
transaction_fee
double
This is the fee charged from the paid amount. Whether the merchant is charged or the customer, depending on your merchant setting, the fees will be included in this field.
total_debit
double
This is the amount including the transaction_fee withdrawn from your account.
provider_id
string
This is the provider the customer is expected to pay from
merchant_reference
string
This is the reference passed earlier in the request
internal_reference
string
This is our internal reference. Useful when dealing with transaction issues. Store it.
transaction_status
string
The status of the transaction
transaction_type
string
payout The type of transaction made
message
string
The reason or message based on the transaction status
1
{
2
"api_key": "PUBK-***",
3
"currency": "USD",
4
"amount": 0.2,
5
"method": "MOBILE_MONEY",
6
"provider_id": "mtn_ug",
7
"account_number": "256777044237",
8
"account_name": "John Doe",
9
"account_email": "[email protected]",
10
"merchant_reference": "AdIVeSAdeLEsta",
11
"narration": "Withdraw Payment"
12
}
13
14
15
// With extra parameters
16
{
17
"api_key": "PUBK-***",
18
"currency": "USD",
19
"amount": 0.2,
20
"method": "BANK",
21
"provider_id": "bank_gh",
22
"account_number": "1000909898989",
23
"account_name": "John Doe",
24
"account_email": "[email protected]",
25
"merchant_reference": "AdIVeSAdeLEsta",
26
"narration": "Hospital Bill",
27
"extra_params": {
28
"bank_code": "6876132",
29
"branch_code": "7898"
30
},
31
}
Copied!
1
{
2
"code": 202,
3
"status": "accepted",
4
"message": "Transaction Initiated",
5
"data": {
6
"id": 124468,
7
"request_amount": 700,
8
"request_currency": "UGX",
9
"account_amount": 700,
10
"account_currency": "UGX",
11
"transaction_fee": 1500,
12
"total_debit": 2200,
13
"provider_id": "mtn_ug",
14
"merchant_reference": "payout-1005",
15
"internal_reference": "DUSUPAY405GZMDVTKASJL8UQ",
16
"transaction_status": "PENDING",
17
"transaction_type": "payout",
18
"message": "Transaction Initiated"
19
}
20
}
Copied!
1
{
2
"id": 226,
3
"request_amount": 0.2,
4
"request_currency": "USD",
5
"account_amount": 737.9934,
6
"account_currency": "UGX",
7
"transaction_fee": 21.4018,
8
"total_debit": 716.5916,
9
"provider_id": "mtn_ug",
10
"merchant_reference": "76859aae-f148-48c5-9901-2e474cf19b71",
11
"internal_reference": "DUSUPAY405GZM1G5JXGA71IK",
12
"transaction_status": "COMPLETED",
13
"transaction_type": "payout",
14
"message": "Transaction Completed Successfully",
15
"account_number": "256777111786 - Optional",
16
"account_name": "- Optional",
17
"institution_name": "MTN Mobile Money - Optional"
18
}
Copied!

Last modified 3mo ago
Copy link