Refund Events

Supported events for Refunds:

1. refund.pending— sent immediately when a refund is initiated

2. refund.successful

3. refund.failed

We support 2 refund type:- full value and partial value

refund.pending

{ 
  "event": "refund.pending", 
  "data": { 
    "merchantId": "6684f2df681exxxxxxx", 
    "originalTransactionReference": "ca80e2606941", 
    "refundReference": "Rca80e2606941-1", 
    "amount": 6700, 
    "currency": "NGN", 
    "refundType": "full", 
    "status": "pending", 
    "reason": "customer no gree", 
    "customerEmail": "[e-mail]", 
    "createdAt": "2026-03-05T08:55:09.103Z", 
    "updatedAt": "2026-03-05T08:55:09.103Z", 
    "channel": "dashboard" 
  } 
}

refund.successful

{ 
  "event": "refund.successful", 
  "data": { 
    "merchantId": "6684f2df681eb8xxxxxxx", 
    "originalTransactionReference": "ca80e2606941", 
    "refundReference": "Rca80e2606941-1", 
    "amount": 6700, 
    "currency": "NGN", 
    "refundType": "full", 
    "status": "successful", 
    "reason": "customer no gree", 
    "customerEmail": "[e-mail]", 
    "createdAt": "2026-03-05T08:55:09.103Z", 
    "updatedAt": "2026-03-05T09:04:57.289Z", 
    "channel": "dashboard" 
  } 
}

refund.failed

{ 
  "event": "refund.failed", 
  "data": { 
    "merchantId": "6684f2df681eb8xxxxxxxx", 
    "originalTransactionReference": "c2c298d3132f", 
    "refundReference": "Rc2c298d3132f-1", 
    "amount": 5000, 
    "currency": "NGN", 
    "refundType": "full", 
    "status": "failed", 
    "reason": "product soldout", 
    "customerEmail": "[e-mail]", 
    "createdAt": "2026-03-05T09:10:24.507Z", 
    "updatedAt": "2026-03-05T09:11:26.079Z", 
    "channel": "dashboard" 
  } 
}