> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchant Risk Actions Webhooks

> Receive webhooks when payment acceptance or settlement is stopped or reversed, or the payment_gateway product is suspended or unsuspended, with sample payloads.

Available in🇮🇳 India

Razorpay sends these events when an [action](https://razorpay.com/docs/partners/aggregators/merchant-risk/actions.md) changes a sub-merchant's `payment_gateway` product, whether Razorpay took it or you took it through the [Partner Actions API](https://razorpay.com/docs/api/partners/accounts/merchant-risk/actions.md). Know more about [subscribing to and handling webhooks](https://razorpay.com/docs/partners/aggregators/merchant-risk.md#receive-webhooks).

| Webhook Event | Description |
| - | - |
| `account.product.payment_gateway.payment_acceptance.disabled` | Payment acceptance was disabled, by Razorpay or by you. |
| `account.product.payment_gateway.payment_acceptance.enabled` | Payment acceptance was enabled again, by the side that disabled it. |
| `account.product.payment_gateway.settlement.on_hold` | Settlement was put on hold, by Razorpay or by you. |
| `account.product.payment_gateway.settlement.enabled` | Settlement was released, by the side that put it on hold. |
| `account.product.payment_gateway.suspended` | The `payment_gateway` product was suspended, by Razorpay or by you. Both objects are stopped. |
| `account.product.payment_gateway.activated` | A suspension was reversed. Both objects are `enabled`. |

A suspension sends `account.product.payment_gateway.suspended` only. It does not also send the object events. Reversing a suspension sends `account.product.payment_gateway.activated` only.

## Payment Acceptance Disabled

Triggered when payment acceptance is disabled. `initiated_by` says who disabled it, and only that side can enable it again. While it is `disabled`, the sub-merchant cannot take new payments.

```json Payload theme={null}
{
  "entity": "event",
  "account_id": "acc_Rk9Xm2Qp7Zt4Nb",
  "event": "account.product.payment_gateway.payment_acceptance.disabled",
  "payload": {
    "account": {
      "id": "acc_Rk9Xm2Qp7Zt4Nb",
      "products": {
        "payment_gateway": {
          "payment_acceptance": {
            "status": "disabled",
            "status_reason": {
              "code": "partner_policy",
              "description": "The merchant broke your policy.",
              "requirement_id": null
            },
            "initiated_by": "partner",
            "updated_at": 1795710000
          }
        }
      }
    }
  },
  "created_at": 1795710001
}
```

## Payment Acceptance Enabled

Triggered when the side that disabled payment acceptance enables it again. `status_reason` and `initiated_by` are `null`.

```json Payload theme={null}
{
  "entity": "event",
  "account_id": "acc_Rk9Xm2Qp7Zt4Nb",
  "event": "account.product.payment_gateway.payment_acceptance.enabled",
  "payload": {
    "account": {
      "id": "acc_Rk9Xm2Qp7Zt4Nb",
      "products": {
        "payment_gateway": {
          "payment_acceptance": {
            "status": "enabled",
            "status_reason": null,
            "initiated_by": null,
            "updated_at": 1795783800
          }
        }
      }
    }
  },
  "created_at": 1795058401
}
```

## Settlement On Hold

Triggered when settlement is put on hold. While on hold, the sub-merchant can keep taking payments, but Razorpay does not settle them. When `status_reason.requirement_id` is set, [answer that requirement](https://razorpay.com/docs/api/partners/accounts/merchant-risk/clarifications.md#answer-requirements) to get the hold reviewed.

```json Payload theme={null}
{
  "entity": "event",
  "account_id": "acc_Rk9Xm2Qp7Zt4Nb",
  "event": "account.product.payment_gateway.settlement.on_hold",
  "payload": {
    "account": {
      "id": "acc_Rk9Xm2Qp7Zt4Nb",
      "products": {
        "payment_gateway": {
          "settlement": {
            "status": "on_hold",
            "status_reason": {
              "code": "prohibited_business",
              "description": "Razorpay can't support this business model.",
              "requirement_id": "req_UYTBV02QSYTRVK"
            },
            "initiated_by": "razorpay",
            "updated_at": 1794481600
          }
        }
      }
    }
  },
  "created_at": 1794481601
}
```

## Settlement Enabled

Triggered when the side that put settlement on hold releases it. Razorpay settles payments on the usual schedule again.

```json Payload theme={null}
{
  "entity": "event",
  "account_id": "acc_Rk9Xm2Qp7Zt4Nb",
  "event": "account.product.payment_gateway.settlement.enabled",
  "payload": {
    "account": {
      "id": "acc_Rk9Xm2Qp7Zt4Nb",
      "products": {
        "payment_gateway": {
          "settlement": {
            "status": "enabled",
            "status_reason": null,
            "initiated_by": null,
            "updated_at": 1795600200
          }
        }
      }
    }
  },
  "created_at": 1795600201
}
```

## Product Suspended

Triggered when Razorpay or you suspend the `payment_gateway` product. Both objects are stopped with the same `status_reason` and `initiated_by`. While suspended, every action other than `unsuspend` returns `400 product_suspended`. Only the side in `initiated_by` can reverse the suspension.

```json Payload theme={null}
{
  "entity": "event",
  "account_id": "acc_Rk9Xm2Qp7Zt4Nb",
  "event": "account.product.payment_gateway.suspended",
  "payload": {
    "account": {
      "id": "acc_Rk9Xm2Qp7Zt4Nb",
      "products": {
        "payment_gateway": {
          "status": "suspended",
          "payment_acceptance": {
            "status": "disabled",
            "status_reason": {
              "code": "prohibited_business",
              "description": "Razorpay can't support this business model.",
              "requirement_id": null
            },
            "initiated_by": "razorpay",
            "updated_at": 1795982400
          },
          "settlement": {
            "status": "on_hold",
            "status_reason": {
              "code": "prohibited_business",
              "description": "Razorpay can't support this business model.",
              "requirement_id": null
            },
            "initiated_by": "razorpay",
            "updated_at": 1795982400
          }
        }
      }
    }
  },
  "created_at": 1795982401
}
```

## Product Activated After a Suspension

Triggered when the side that suspended the product reverses the suspension. The product is `activated`, and both objects are `enabled`. An action that was in place before the suspension does not come back.

```json Payload theme={null}
{
  "entity": "event",
  "account_id": "acc_Rk9Xm2Qp7Zt4Nb",
  "event": "account.product.payment_gateway.activated",
  "payload": {
    "account": {
      "id": "acc_Rk9Xm2Qp7Zt4Nb",
      "products": {
        "payment_gateway": {
          "status": "activated",
          "payment_acceptance": {
            "status": "enabled",
            "status_reason": null,
            "initiated_by": null,
            "updated_at": 1796414400
          },
          "settlement": {
            "status": "enabled",
            "status_reason": null,
            "initiated_by": null,
            "updated_at": 1796414400
          }
        }
      }
    }
  },
  "created_at": 1796414401
}
```

## Related

* [About actions](https://razorpay.com/docs/partners/aggregators/merchant-risk/actions.md)
* [Partner Actions API](https://razorpay.com/docs/api/partners/accounts/merchant-risk/actions.md)
* [Clarifications webhooks](https://razorpay.com/docs/partners/aggregators/merchant-risk/clarifications-webhooks.md)
