Skip to main content
POST
Create Refund
Refund a completed payment, either fully or partially. The merchant wallet is debited and the user wallet is credited.

Endpoint

POST https://quickei.io/pay/sandbox/api/v1/refunds

Parameters

string
required
The original payment transaction ID (e.g. TRX-98765).
decimal
Amount to refund. Omit for a full refund. Must be greater than 0 and not exceed the remaining refundable amount.
string
Reason for the refund (max 500 chars).
string
Your internal reference for this refund (max 255 chars).
string
Unique key to prevent duplicate refunds (max 64 chars).
Partial refunds: You can issue multiple partial refunds against the same transaction until the total refunded amount equals the original payment amount.

Example Request

Success Response 200

Response Fields

Error Responses

404 Transaction not found

422 Refund exceeds original amount

422 Transaction not refundable