Dusupay
Search…
GETTING STARTED
RECEIVING MONEY
APPENDIX
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/jsonYES
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, BANKYES
provider_id
string
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 IBANYES
account_name
string
The name of the customer’s account
YES
account_email
string
The email address of the customer
NO
merchant_reference
string
YES,
4 to 36 characternarration
string
Use this to add a brief description or comment on the transaction.
YES,
4 to 64 charactersextra_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_paramsthe 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
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
​
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
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 mademessage
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