Skip to main content
Available in🇮🇳 India
If a reviewer needs more information, the product’s status becomes needs_clarification. Its requirements list only the flagged points, with the reviewer’s reason in each requirement_reason. Know more about review reasons. Each point is usually a one_of composite requirement:
  • For the bank account: A new account (settlement_bank_account), a ₹1 UPI payment (create_upi_link) or a reply (clarify_bank_account).
  • For the website: A new website (website_url) or a reply (clarify_website).
bank_account

6.1 Show the Flagged Points

Fetch the account and show the sub-merchant each flagged point’s requirement_reason and description. The account.product.needs_clarification webhook also carries the product with its complete requirements. GET /v1/accounts/{account_id}

6.2 Answer Each Point

Answer each point with a corrected value, a document or a text reply, in an update. A text reply goes in products.payment_gateway.clarification_responses when the point offers a reply input, such as clarify_bank_account. Key each reply by the path of what it answers, as one dotted key. For example, bank_accounts.settlements_primary answers the bank account. The key is the reply input’s field_path after products.payment_gateway.clarification_responses.. A reply is offered only in needs_clarification, never after a failed check. PATCH /v1/accounts/{account_id}
Curl
The response shows the replies on the product, in clarification_responses. Once every flagged point is answered, submit_clarification is the only requirement left:
products.payment_gateway
Watch Out!Only the listed fields can change. Changing anything else returns 409 field_locked.
products.payment_gateway.clarification_responses optional : object The sub-merchant’s text replies to the flagged points. Each key is the path of what the reply answers, such as bank_accounts.settlements_primary, and each value is the reply.products.payment_gateway.clarification_responses.<path> optional : string One reply. A reply to clarify_bank_account takes 50 to 300 characters.

6.3 Resubmit the Product

Once every flagged point is answered, the product’s submit_clarification is due at products.payment_gateway.submit_clarification. Send it in its own update. Never send a reply and submit_clarification in the same body. The product returns to under_review. PATCH /v1/accounts/{account_id}
Curl
If the sub-merchant does not answer in time, Razorpay rejects the product with status_reason.code clarification_not_answered.

Next Step

Track Product Status
Last modified on November 18, 2026