> For the complete documentation index, see [llms.txt](https://startbutton.gitbook.io/startbutton-product-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://startbutton.gitbook.io/startbutton-product-api/webhooks/refund-events.md).

# 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

{% tabs %}
{% tab title="refund.pending" %}

```json
{ 
  "event": "refund.pending", 
  "data": { 
    "merchantId": "6684f2df681exxxxxxx", 
    "originalTransactionReference": "ca80e2606941", 
    "refundReference": "Rca80e2606941-1", 
    "amount": 6700, 
    "currency": "NGN", 
    "refundType": "full", 
    "status": "pending", 
    "reason": "service no longer needed", 
    "customerEmail": "test-pms@customer.com", 
    "createdAt": "2026-03-05T08:55:09.103Z", 
    "updatedAt": "2026-03-05T08:55:09.103Z", 
    "channel": "dashboard" 
  } 
}
```

{% endtab %}

{% tab title="refund.successful" %}

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

{% endtab %}

{% tab title="refund.failed" %}

```json
{ 
  "event": "refund.failed", 
  "data": { 
    "merchantId": "6684f2df681eb8xxxxxxxx", 
    "originalTransactionReference": "c2c298d3132f", 
    "refundReference": "Rc2c298d3132f-1", 
    "amount": 5000, 
    "currency": "NGN", 
    "refundType": "full", 
    "status": "failed", 
    "reason": "product soldout", 
    "customerEmail": "test-pms@customer.com", 
    "createdAt": "2026-03-05T09:10:24.507Z", 
    "updatedAt": "2026-03-05T09:11:26.079Z", 
    "channel": "dashboard" 
  } 
}
```

{% endtab %}
{% endtabs %}