> ## 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 Clarifications Webhooks

> Receive webhooks when Razorpay raises a risk requirement, when its status changes, when it is resolved and when its deadline passes, with sample payloads.

Available in🇮🇳 India

Razorpay sends these events as a [clarification](https://razorpay.com/docs/partners/aggregators/merchant-risk/clarifications.md) moves through its statuses. Each event carries the whole requirement it is about, at `products.payment_gateway.requirements`. 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.requirement.needs_clarification` | A requirement moved to `needs_clarification`: Razorpay raised it, or asked again after a review. |
| `account.product.payment_gateway.requirement.under_review` | A requirement moved to `under_review` after you submitted your responses. |
| `account.product.payment_gateway.requirement.overdue` | A requirement moved to `overdue`: `due_at` passed with responses still due. |
| `account.product.payment_gateway.requirement.resolved` | A requirement moved to `resolved`. |

Each event is named after the status the requirement moved to. Know more about [statuses](https://razorpay.com/docs/partners/aggregators/merchant-risk/clarifications.md#statuses).

## Requirement Needs Clarification

Triggered when Razorpay raises a requirement after a risk review, and again when Razorpay asks again after reviewing your responses. Show each `input` requirement to the sub-merchant and [answer them in one update](https://razorpay.com/docs/api/partners/accounts/merchant-risk/clarifications.md#answer-requirements) before `due_at`. The product's `status` does not change.

The sample below shows a new requirement.

```json Payload theme={null}
{
  "entity": "event",
  "account_id": "acc_Rk9Xm2Qp7Zt4Nb",
  "event": "account.product.payment_gateway.requirement.needs_clarification",
  "payload": {
    "account": {
      "id": "acc_Rk9Xm2Qp7Zt4Nb",
      "products": {
        "payment_gateway": {
          "requirements": [
            {
              "id": "req_UYTBV02QSYTRVK",
              "requirement_code": "ri_bmc_additional_details",
              "requirement_level": "mandatory",
              "requirement_type": "composite",
              "description": "Resolve the observations raised during review.",
              "fulfillment_criteria": "all_of",
              "sub_requirements": [
                {
                  "id": "req_BMC1clarify01",
                  "requirement_code": "business_model_clarification",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Explain your Business Model in Detail for better understanding.",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "text",
                  "response": null,
                  "status": "needs_clarification"
                },
                {
                  "id": "req_PODdoc00021",
                  "requirement_code": "proof_of_delivery",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Proof of Delivery",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "document",
                  "response": null,
                  "status": "needs_clarification"
                },
                {
                  "id": "req_F12Adoc0022",
                  "requirement_code": "form_12a",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Form 12A",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "document",
                  "response": null,
                  "status": "needs_clarification"
                },
                {
                  "id": "req_ANYelse00004",
                  "requirement_code": "additional_information",
                  "requirement_level": "optional",
                  "requirement_type": "input",
                  "description": "Anything else you would like to add",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "text",
                  "response": null,
                  "status": "needs_clarification"
                }
              ],
              "status": "needs_clarification",
              "due_at": 1795305600
            }
          ]
        }
      }
    }
  },
  "created_at": 1794481301
}
```

## Requirement Under Review

Triggered when you submit your responses, from `needs_clarification` or `overdue`. Razorpay is reviewing them. The sample below shows the requirement after you sent every response.

```json Payload theme={null}
{
  "entity": "event",
  "account_id": "acc_Rk9Xm2Qp7Zt4Nb",
  "event": "account.product.payment_gateway.requirement.under_review",
  "payload": {
    "account": {
      "id": "acc_Rk9Xm2Qp7Zt4Nb",
      "products": {
        "payment_gateway": {
          "requirements": [
            {
              "id": "req_UYTBV02QSYTRVK",
              "requirement_code": "ri_bmc_additional_details",
              "requirement_level": "mandatory",
              "requirement_type": "composite",
              "description": "Resolve the observations raised during review.",
              "fulfillment_criteria": "all_of",
              "sub_requirements": [
                {
                  "id": "req_BMC1clarify01",
                  "requirement_code": "business_model_clarification",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Explain your Business Model in Detail for better understanding.",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "text",
                  "response": {
                    "text": "We sell healthy packaged meals online and at our studio cafe.",
                    "created_at": 1795305120,
                    "updated_at": 1795305120,
                    "metadata": {}
                  },
                  "status": "under_review"
                },
                {
                  "id": "req_PODdoc00021",
                  "requirement_code": "proof_of_delivery",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Proof of Delivery",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "document",
                  "response": {
                    "documents": [
                      {
                        "id": "doc_PdL9mA2Qv7"
                      }
                    ],
                    "created_at": 1795305120,
                    "updated_at": 1795305120,
                    "metadata": {}
                  },
                  "status": "under_review"
                },
                {
                  "id": "req_F12Adoc0022",
                  "requirement_code": "form_12a",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Form 12A",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "document",
                  "response": {
                    "documents": [
                      {
                        "id": "doc_F12aRt4Pn8"
                      }
                    ],
                    "created_at": 1795305120,
                    "updated_at": 1795305120,
                    "metadata": {}
                  },
                  "status": "under_review"
                },
                {
                  "id": "req_ANYelse00004",
                  "requirement_code": "additional_information",
                  "requirement_level": "optional",
                  "requirement_type": "input",
                  "description": "Anything else you would like to add",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "text",
                  "response": null,
                  "status": "under_review"
                }
              ],
              "status": "under_review",
              "due_at": 1795305600
            }
          ]
        }
      }
    }
  },
  "created_at": 1795305121
}
```

## Requirement Overdue

Triggered when `due_at` passes with responses still due. The requirement moves to `overdue`. The sample below shows the alternative path, where `due_at` passes before you submit, so it is not a step after the `under_review` sample above. Razorpay reviews the account and may disable payments, put settlement on hold or suspend the product, each with its own event. You can still respond. Your submit moves the requirement to `under_review`.

```json Payload theme={null}
{
  "entity": "event",
  "account_id": "acc_Rk9Xm2Qp7Zt4Nb",
  "event": "account.product.payment_gateway.requirement.overdue",
  "payload": {
    "account": {
      "id": "acc_Rk9Xm2Qp7Zt4Nb",
      "products": {
        "payment_gateway": {
          "requirements": [
            {
              "id": "req_UYTBV02QSYTRVK",
              "requirement_code": "ri_bmc_additional_details",
              "requirement_level": "mandatory",
              "requirement_type": "composite",
              "description": "Resolve the observations raised during review.",
              "fulfillment_criteria": "all_of",
              "sub_requirements": [
                {
                  "id": "req_BMC1clarify01",
                  "requirement_code": "business_model_clarification",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Explain your Business Model in Detail for better understanding.",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "text",
                  "response": null,
                  "status": "overdue"
                },
                {
                  "id": "req_PODdoc00021",
                  "requirement_code": "proof_of_delivery",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Proof of Delivery",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "document",
                  "response": null,
                  "status": "overdue"
                },
                {
                  "id": "req_F12Adoc0022",
                  "requirement_code": "form_12a",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Form 12A",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "document",
                  "response": null,
                  "status": "overdue"
                },
                {
                  "id": "req_ANYelse00004",
                  "requirement_code": "additional_information",
                  "requirement_level": "optional",
                  "requirement_type": "input",
                  "description": "Anything else you would like to add",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "text",
                  "response": null,
                  "status": "overdue"
                }
              ],
              "status": "overdue",
              "due_at": 1795305600
            }
          ]
        }
      }
    }
  },
  "created_at": 1795305601
}
```

## Requirement Resolved

Triggered when Razorpay resolves the requirement, after its review or, in exceptional cases, without your responses. If an action pointed to it, the action's own event follows when Razorpay reverses it, or `account.product.payment_gateway.suspended` follows if Razorpay escalates. A resolved requirement no longer appears in `requirements` when you fetch the account.

```json Payload theme={null}
{
  "entity": "event",
  "account_id": "acc_Rk9Xm2Qp7Zt4Nb",
  "event": "account.product.payment_gateway.requirement.resolved",
  "payload": {
    "account": {
      "id": "acc_Rk9Xm2Qp7Zt4Nb",
      "products": {
        "payment_gateway": {
          "requirements": [
            {
              "id": "req_UYTBV02QSYTRVK",
              "requirement_code": "ri_bmc_additional_details",
              "requirement_level": "mandatory",
              "requirement_type": "composite",
              "description": "Resolve the observations raised during review.",
              "fulfillment_criteria": "all_of",
              "sub_requirements": [
                {
                  "id": "req_BMC1clarify01",
                  "requirement_code": "business_model_clarification",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Explain your Business Model in Detail for better understanding.",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "text",
                  "response": {
                    "text": "We sell healthy packaged meals online and at our studio cafe.",
                    "created_at": 1795305120,
                    "updated_at": 1795305120,
                    "metadata": {}
                  },
                  "status": "resolved"
                },
                {
                  "id": "req_PODdoc00021",
                  "requirement_code": "proof_of_delivery",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Proof of Delivery",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "document",
                  "response": {
                    "documents": [
                      {
                        "id": "doc_PdL9mA2Qv7"
                      }
                    ],
                    "created_at": 1795305120,
                    "updated_at": 1795305120,
                    "metadata": {}
                  },
                  "status": "resolved"
                },
                {
                  "id": "req_F12Adoc0022",
                  "requirement_code": "form_12a",
                  "requirement_level": "mandatory",
                  "requirement_type": "input",
                  "description": "Form 12A",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "document",
                  "response": {
                    "documents": [
                      {
                        "id": "doc_F12aRt4Pn8"
                      }
                    ],
                    "created_at": 1795305120,
                    "updated_at": 1795305120,
                    "metadata": {}
                  },
                  "status": "resolved"
                },
                {
                  "id": "req_ANYelse00004",
                  "requirement_code": "additional_information",
                  "requirement_level": "optional",
                  "requirement_type": "input",
                  "description": "Anything else you would like to add",
                  "field_path": "products.payment_gateway.requirements.requirement_response",
                  "value_type": "text",
                  "response": null,
                  "status": "resolved"
                }
              ],
              "status": "resolved",
              "due_at": 1795305600
            }
          ]
        }
      }
    }
  },
  "created_at": 1795600001
}
```

## Related

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