post
https://api.zwitch.io/refund/batch
Initiates a batch of refunds in a single request. Each refund item is processed independently — some may succeed while others are rejected within the same batch.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Refund Status
Each refund item in the response includes a refund_status field indicating the outcome of that specific refund request.
Per-Item refund_status Values
refund_status Values| Status | Meaning |
|---|---|
request_initiated | Refund accepted and queued for processing. |
rejected | Refund rejected — see the message field for the reason. |
Rejection Reasons (message field)
message field)When refund_status is rejected, the message field will contain one of the following values:
| Message | Cause |
|---|---|
merchant_reference_id already exists | Duplicate merchant_reference_id — already exists in the database or appears more than once within the same batch. |
Invalid payment_id | The provided payment_id was not found for this merchant. |
Payment is not in a refundable status | The payment has not been captured or paid yet and cannot be refunded. |
Amount exceeds transaction amount | The requested refund amount is greater than the original transaction value. |
Total refund amount exceeds transaction amount | The cumulative refund total (including prior refunds and this batch) would exceed the original transaction value. |
refund_batch_id already exists | The entire batch is rejected — this refund_batch_id has already been submitted. |
Refunds are not allowed for instant settlement enabled merchants | Entire batch rejected — merchant has instant settlement enabled. |