5. Execute Reverse / Refund Request

Initiate refunds and reversals on completed transactions. Supports full and partial refunds with configurable reasons and automatic reconciliation.

POST/v1/refunds/initiate

Required Headers

Authorization:Bearer sec_key_live_••••••••••••••••

Content-Type:application/json

Request Body

JSON Payload

{
  "transaction_reference": "TXN-CARD-90811A",
  "amount": 2500,
  "reason": "Customer canceled diagnostic booking within threshold policy."
}

Response

Response Payload

{
  "status": "success",
  "refund_reference": "REF-88192-A",
  "original_transaction": "TXN-CARD-90811A",
  "amount_refunded": 2500,
  "status_message": "Refund fully processed into native scheme channel."
}