> ## 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 APIs

> Endpoints to read a sub-merchant's risk profile, disable or enable its payments and settlement, and answer Razorpay's risk clarifications through the Accounts API.

Available in🇮🇳 India

Use the Merchant Risk APIs to read Razorpay's risk rating of each sub-merchant, disable or enable its payments and settlement, and answer the clarifications Razorpay raises after a risk review. They work on the account you already use for onboarding, on its `payment_gateway` product, with the same credentials and headers as the [Accounts API](https://razorpay.com/docs/api/partners/accounts). Know more about [how merchant risk works](https://razorpay.com/docs/partners/aggregators/merchant-risk.md).

## Endpoints

> [card] [Fetch a Risk Profile](https://razorpay.com/docs/api/partners/accounts/merchant-risk/risk-profile.md)
>
> `GET` `/v1/accounts/:account_id`
>
> Retrieves the account with Razorpay's risk rating of the sub-merchant.

> [card] [Take a Partner Action](https://razorpay.com/docs/api/partners/accounts/merchant-risk/actions.md)
>
> `POST` `/v1/accounts/:account_id/products/payment_gateway/actions/:action`
>
> Disables or enables payments or settlement, or suspends or unsuspends the product.

> [card] [Fetch a Requirement](https://razorpay.com/docs/api/partners/accounts/merchant-risk/clarifications.md#fetch-a-requirement)
>
> `GET` `/v1/accounts/:account_id/products/payment_gateway/requirements/:requirement_id`
>
> Retrieves one risk requirement with its sub-requirements.

> [card] [Upload a Document](https://razorpay.com/docs/api/partners/accounts/merchant-risk/clarifications.md#upload-a-document)
>
> `POST` `/v1/accounts/:account_id/documents/:document_type`
>
> Stores one file for a document requirement and returns its document ID.

> [card] [Answer Requirements](https://razorpay.com/docs/api/partners/accounts/merchant-risk/clarifications.md#answer-requirements)
>
> `PATCH` `/v1/accounts/:account_id`
>
> Sends your responses to a clarification in one call.

## Reason Codes, Webhooks and Errors

Refer to these pages for the reason codes, webhooks and errors:

* [Reason Codes](https://razorpay.com/docs/api/partners/accounts/merchant-risk/reason-codes.md)
* [Risk Profile Webhook](https://razorpay.com/docs/api/partners/accounts/merchant-risk/risk-profile.md#webhook)
* [Actions Webhooks](https://razorpay.com/docs/partners/aggregators/merchant-risk/actions-webhooks.md)
* [Clarifications Webhooks](https://razorpay.com/docs/partners/aggregators/merchant-risk/clarifications-webhooks.md)
* [Errors](https://razorpay.com/docs/api/partners/accounts/merchant-risk/errors.md)

## Related Guides

Refer to these guides for how each part works:

* [Merchant Risk Overview](https://razorpay.com/docs/partners/aggregators/merchant-risk.md)
* [About the Risk Profile](https://razorpay.com/docs/partners/aggregators/merchant-risk/risk-profile.md)
* [About Actions](https://razorpay.com/docs/partners/aggregators/merchant-risk/actions.md)
* [About Clarifications](https://razorpay.com/docs/partners/aggregators/merchant-risk/clarifications.md)
