Available in🇮🇳 India
Razorpay sends these events as a clarification 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.
| 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. |
Requirement Needs Clarification
Triggered when Razorpay raises a requirement after a risk review, and again when Razorpay asks again after reviewing your responses. Show eachinput requirement to the sub-merchant and answer them in one update before due_at. The product’s status does not change.
The sample below shows a new requirement.
Payload
{
"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, fromneeds_clarification or overdue. Razorpay is reviewing them. The sample below shows the requirement after you sent every response.
Payload
{
"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 whendue_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.
Payload
{
"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, oraccount.product.payment_gateway.suspended follows if Razorpay escalates. A resolved requirement no longer appears in requirements when you fetch the account.
Payload
{
"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
}