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

# 3. Supply Requirements

> Read and answer the requirements Razorpay needs before activating a payment method instrument for a sub-merchant.

Available in
🇮🇳 India

A requirement is something Razorpay still needs about the account before it can activate an instrument. It is the same Requirement object the Onboarding APIs return, filtered to the instrument. There is no separate clarification object to track.

A requirement describes the account. One requirement can appear on several instruments, and answering it once fulfils it for all of them.

## 3.1 Read the Requirements

Read `requirements` on the instrument. For a netbanking bank that needs onboarding:

```json Response theme={null}
{
  "bank": "kkbk",
  "name": "Kotak Mahindra Bank",
  "status": "in_progress",
  "enabled": false,
  "requirements": [
    {
      "id": "req_Qd3Kp8Lm2Vx7Tn",
      "requirement_code": "gstin",
      "description": "The GSTIN of the business.",
      "requirement_reason": "Kotak Mahindra Bank needs it to onboard the account.",
      "requirement_level": "mandatory",
      "requirement_type": "input",
      "status": "pending",
      "due_at": null,
      "field_path": "business_profile.identity_numbers.gstin",
      "value_type": "text",
      "response": null
    },
    {
      "id": "req_Rf6Hs1Zb9Yc4Wg",
      "requirement_code": "shop_establishment",
      "description": "The shop and establishment certificate of the business.",
      "requirement_reason": "Kotak Mahindra Bank needs it to onboard the account.",
      "requirement_level": "mandatory",
      "requirement_type": "input",
      "status": "pending",
      "due_at": null,
      "field_path": "business_profile.documents.shop_establishment",
      "value_type": "document",
      "response": null,
      "metadata": {
        "constraints": {
          "accept": ["application/pdf", "image/jpeg", "image/png"],
          "max_size_mb": 20
        }
      }
    }
  ]
}
```

## 3.2 Answer Each Requirement

How you answer depends on `requirement_type`:

| `requirement_type` | What it asks for | How to answer |
| - | - | - |
| `input` | A value or a document, at `field_path`. | [Update the account](https://razorpay.com/docs/api/partners/accounts/update.md) with the value at `field_path`. For a document, [upload it](https://razorpay.com/docs/api/partners/accounts/upload-document.md) and send its id, or send a `url`. |
| `action` | A step to run, named in `requirement_code`. | [Run the action](https://razorpay.com/docs/api/partners/accounts/run-action.md). |
| `composite` | One point answered in more than one way, or with several values. | Answer its `sub_requirements` as `fulfillment_criteria` says: any one for `one_of`, one or more for `any_of`, every mandatory one for `all_of`. |

Know more about the [requirement object](https://razorpay.com/docs/api/partners/accounts/requirement-entity.md) and how to [collect requirements](https://razorpay.com/docs/partners/aggregators/onboarding-api/collect-requirements.md).

## 3.3 Confirm the Answer

Fetch its payment method again. An answered requirement shows `status: fulfilled` and the answer in `response`. Razorpay continues the onboarding on its own. There is no separate answer call, and nothing to resubmit or restart.

## 3.4 Answer a Clarification

When Razorpay or a bank asks for more, the instrument's status is `needs_clarification`. `requirements` lists the flagged points, with the reviewer's comment in `requirement_reason`. A flagged point is usually a `one_of` composite.

Answer with a corrected value or document, or with a text reply where the point offers a reply input. Know more about [handling needs clarification](https://razorpay.com/docs/partners/aggregators/onboarding-api/needs-clarification.md).

> [!WARNING]
>
> **Watch Out!**
>
> * A requirement can carry a `due_at` deadline, as a Unix timestamp in seconds. It is `null` when there is none.
> * Send a document that matches `metadata.constraints`: the accepted file types and the maximum size.
> * `requirement_level` can be `mandatory`, `conditional` or `optional`. A `conditional` requirement is needed only in some cases, such as the option you take in a `one_of`.

## Next Step

[Follow Onboarding](https://razorpay.com/docs/partners/aggregators/onboarding-api/payment-methods/follow-onboarding.md)
