# Payout Webhooks

Payout webhooks notify you about payout 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 |
|  --- | --- |
|  pending_approval  | The payout has been submitted under maker-checker and is awaiting approval. |
|  queued  | The payout has been accepted but the balance does not yet cover it. Glomo releases it automatically once the balance is sufficient. |
|  in_progress  | The payout has been accepted and is being processed. |
|  action_required  | The payout requires more details to be processed. |
|  success  | The payout has been successfully processed. |
|  failed  | The payout has failed. |
|  cancelled  | The payout has been cancelled. Includes auto-cancellation when a linked quote expires before submission, in which case `error_code` is `QUOTE_EXPIRED`. |


## Sample Payload

```Sample
{
  "entity_type": "payout",
  "event_type": "in_progress",
  "data": {
    "id": "payout_9z8y7x6w5v",
    "beneficiary_id": "bene_a1b2c3d4e5",
    "source_amount": 100000,
    "source_currency": "USD",
    "destination_amount": 8235000,
    "destination_currency": "INR",
    "purpose_code": "S0802",
    "status": "in_progress",
    "fees": {
      "txn_fee": {
        "currency": "USD",
        "amount": 500
      },
      "fx_fee": {
        "currency": "USD",
        "amount": 250
      }
    },
    "mid_market_rate": {
      "currency": "INR",
      "rate": 83.12
    },
    "documents": [
      "doc_11aa22bb33"
    ],
    "utr": null,
    "created_at": "2026-06-03T10:20:00Z",
    "updated_at": "2026-06-03T10:20:00Z",
    "fee_collection_mode": "merchant",
    "request_id": "req-7f3a9c20",
    "payment_rail": "neft",
    "invoice_number": "INV-2026-001",
    "notes": {
      "internal_ref": "batch-42"
    },
    "error_code": null,
    "error_description": null,
    "customer_error_description": null,
    "quote_id": "quote_3m4n5o6p7q",
    "taxes": [],
    "estimated_credit_date": "2026-06-05"
  }
}
```