Sign in

v1

latestOpenAPI 3.1.02026-07-24360204.4 KB

Batch Refund API

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.

post/refund/batch

Request body

refund_batch_idstring required

Unique batch identifier from the merchant. Must not have been used before for this merchant.

Response

200

batch_statusstring
refund_batch_idstring

Example response

{
  "batch_status": "success",
  "refund_batch_id": "BATCH-2026-001",
  "refunds": [
    {
      "refund_id": "rf_xxxxxxxxxxxx",
      "amount": 500,
      "refund_status": "request_initiated",
      "message": "Request initiated successfully",
      "merchant_reference_id": "MER-REF-001"
    }
  ]
}