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’srequirement_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 inproducts.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
clarification_responses. Once every flagged point is answered, submit_clarification is the only requirement left:
products.payment_gateway
Request Parameters
Request Parameters
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’ssubmit_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
status_reason.code clarification_not_answered.