Dusupay
Search…
Refunds
Refunds are currently only available for card payments. To refund customers that paid using other transaction methods, you will need to make payouts using the payouts API.
When you make a refund request, we refund the customer the exact or a fraction of the amount that was paid by the customer in the original transaction. The details are returned in the API response. The funds are debited from your merchant account and a refund request is created for processing. We will also make a callback to your webhook/callback URL set under your merchant account.
Partial refunds may not be available in some scenarios due to the nature of some of our third party providers. When partial refunds are not possible, the API will respond accordingly
1
// sandbox
2
POST https://sandbox.dusupay.com/v1/refund
Copied!
Headers
Request
Sample Response Body
Sample IPN Data

Request

Header
Value
Required
secret-key
SEC-*** Your Merchant secret key
YES

Request

Parameter Name
Type
Description
Required
api_key
string
Merchant Account Public Key
YES
internal_reference
string
The internal reference of the transaction to refund. This is usually included in the API request responses or IPN's
YES
amount
integer
(Optional) Add the amount if you want to do a partial refund. This amount should should be less or equal to the transaction amount in the previous transaction
NO
1
{
2
"code": 202,
3
"status": "accepted",
4
"message": "Refund Initiated Successfully",
5
"data": {
6
"id": 65205,
7
"refund_amount": 1054,
8
"refund_currency": "UGX",
9
"transaction_fee": 0,
10
"total_debit": 1054,
11
"provider_id": "international_ugx",
12
"merchant_reference": "hAkEROAdhIsHrEnB",
13
"collection_reference": "DUSUPAYXYXYXYXYXYXYXYXYX",
14
"internal_reference": "RFD-DUSUPAYXYXYXYXYXYXYXYXYX-3486003",
15
"transaction_type": "refund",
16
"transaction_status": "PENDING",
17
"account_number": "4860610032773134",
18
"message": "Request Initiated"
19
}
20
}
Copied!
1
{
2
"id": 65205,
3
"refund_amount": 1054,
4
"refund_currency": "UGX",
5
"transaction_fee": 0,
6
"total_debit": 1054,
7
"provider_id": "international_ugx",
8
"merchant_reference": "hAkEROAdhIsHrEnB",
9
"collection_reference": "DUSUPAYXYXYXYXYXYXYXYXYX",
10
"internal_reference": "RFD-DUSUPAYXYXYXYXYXYXYXYXYX-3486003",
11
"transaction_type": "refund",
12
"transaction_status": "COMPLETED",
13
"account_number": "486061xxxxxx3134",
14
"message": "Refund Processed Successfully"
15
}
Copied!
Last modified 3mo ago
Copy link