# Refund Webhooks

Refund webhooks notify you about refund lifecycle events.

> **Note:** The sample payloads on this page are pretty-printed. The body Glomo sends is the RFC 8785 canonical form of the same object, and the `X-Glomopay-Signature` header is computed over those bytes. See [Webhook Authentication & Security](/platform/webhooks#webhook-authentication--security).


| Event Type | Description |
|  --- | --- |
|  success  | The refund has been successfully processed. |
|  action_required  | The refund requires more details to be processed. |
|  failed  | The refund failed. |
|  utr.updated  | The refund's `utr` was updated. |


## Sample Payload

```Sample
{
  "entity_type": "refund",
  "event_type": "success",
  "data": {
    "id": "refund_682c42dfkOVpL",
    "payment_id": "payt_681cadccoSbsj",
    "customer_id": "cust_6819d7d0lrLvP",
    "amount": 10000,
    "currency": "USD",
    "balance_used": {
      "currency": "USD",
      "amount": 10000
    },
    "status": "success",
    "reason": "Requested By Customer",
    "fees": {
      "fx_fees": {
        "currency": "USD",
        "amount": 0
      },
      "txn_fees": {
        "currency": "USD",
        "amount": 200
      }
    },
    "documents": [],
    "error_code": null,
    "error_message": null,
    "created_at": "2025-05-20T08:52:47Z",
    "updated_at": "2025-05-20T08:53:55Z",
    "utr": null, // assigned after the refund succeeds, sent via utr.updated
    "partial_refund": false,
    "fee_collection_mode": "immediate"
  }
}
```