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 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.

We currently only support full card refunds. Partial refunds will be supported soon.

// sandbox
POST https://sandbox.dusupay.com/v1/refund
// live
POST https://api.dusupay.com/v1/refund
Headers
Request
Sample Response Body
Sample IPN Data
Headers

Request

Header

Value

Required

secret-key

SEC-*** Your Merchant secret key

YES

Request

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

Sample Response Body
{
"code": 202,
"status": "accepted",
"message": "Refund Initiated Successfully",
"data": {
"id": 65205,
"refund_amount": 1054,
"refund_currency": "UGX",
"transaction_fee": 0,
"total_debit": 1054,
"provider_id": "international_ugx",
"collection_reference": "DUSUPAYXYXYXYXYXYXYXYXYX",
"internal_reference": "RFD-DUSUPAYXYXYXYXYXYXYXYXYX-3486003",
"transaction_type": "refund",
"transaction_status": "PENDING",
"account_number": "4860610032773134",
"message": "Request Initiated"
}
}
Sample IPN Data
{
"id": 65205,
"refund_amount": 1054,
"refund_currency": "UGX",
"transaction_fee": 0,
"total_debit": 1054,
"provider_id": "international_ugx",
"collection_reference": "DUSUPAYXYXYXYXYXYXYXYXYX",
"internal_reference": "RFD-DUSUPAYXYXYXYXYXYXYXYXYX-3486003",
"transaction_type": "refund",
"transaction_status": "COMPLETED",
"account_number": "4860610032773134",
"message": "Refund Processed Successfully"
}