# Merchant Webhooks

Merchant webhooks notify you about lifecycle events related to a merchant account. This applies to partner platform merchants only.

> **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 |
|  --- | --- |
|  action_required  | Glomo requires additional information about the business to proceed with the onboarding |
|  pending  | The merchant is pending onboarding on Glomo's end. |
|  success  | The merchant onboarding completed successfully. |
|  offboarded  | The merchant has been offboarded and access has been revoked. |


## Sample Payload

```Sample
{
  "data": {
    "entity_type": "merchant",
    "event_type": "success",
    "data": {
      "owner_merchant_id": "merch_6909a7b8z9ZHi",
      "merchant_id": "merch_696f362cYrLa1",
      "status": "success",
      "name": "merchant name",
      "registration_number": "your registration number",
      "registration_country": "IND",
      "address": {
        "address_line1": "123 Main St",
        "address_line2": "",
        "city": "Bangalore",
        "state": "Karnataka",
        "pincode": "560060",
        "country": "IND"
      },
      "operation_countries": [
        "IND"
      ],
      "entity_type": "individual",
      "category": "Agricultural Services",
      "sub_category": "Veterinary Services",
      "created_at": "2026-01-20T08:00:44Z",
      "updated_at": "2026-01-20T08:00:44Z",
      "jwt_token": "jwt_token",
      "public_key": "public_key",
      "gender": "male",
      "date_of_birth": "2001-08-04"
    }
  }
}
```