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

# Error Index

> Know about every Onboarding APIs error reason and its Test Mode trigger.

Available in
🇮🇳 India

This page lists every reason an Onboarding API can return. Each comes with its HTTP status, its source and how to trigger it in test mode. Branch on `error.reason`. `error.description` is display text and can change.

> [!NOTE]
>
> **Handy Tips**
>
> A failed check is not an error. The call returns `200`, with the element's `verification.status: rejected` and a `verification.error_code`. See [2. Failed Checks](#2-failed-checks) and the [Test Values](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/test-values.md).

## 1. API Errors

Every API error returns the same error object. Read `error.reason` and `error.field` to decide what to do. Know more about [Onboarding API errors](https://razorpay.com/docs/api/partners/accounts/errors.md).

The table below lists every API error, sorted by HTTP status:

<table>
  <colgroup>
    <col width="6%" />

    <col width="14%" />

    <col width="14%" />

    <col width="26%" />

    <col width="14%" />

    <col width="18%" />

    <col width="8%" />
  </colgroup>

  <thead><tr><th>HTTP</th><th>error.reason</th><th>error.code, error.source and error.step</th><th>When</th><th>Thrown by</th><th>How to trigger in test mode</th><th>Test mode</th></tr></thead>

  <tbody>
    <tr>
      <td>`400`</td>
      <td>`file_name_too_long`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `document_upload`</td>
      <td>The file name is longer than 255 characters.</td>
      <td>Upload</td>
      <td>A file name of 256 characters.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_document_url`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `document_download`</td>
      <td>A document `url` is not HTTPS, or it points or redirects to a private, loopback or cloud-metadata address. It also fires when the file could not be downloaded or failed the upload checks.</td>
      <td>Create, Update</td>
      <td>A document `url` of `https://10.0.0.1/a.pdf`.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_file`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `document_upload`</td>
      <td>The file cannot be read, such as a truncated or corrupt PDF.</td>
      <td>Upload</td>
      <td>A truncated PDF.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_file_name`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `document_upload`</td>
      <td>The file name has characters that are not allowed, such as a path separator or a control character.</td>
      <td>Upload</td>
      <td>A file name with `/`.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_format`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `validation`</td>
      <td>A value does not match its format or range. Examples are a PAN pattern, a phone that is not +91 and 10 digits or a count above 100. `metadata.pattern` or `metadata.minimum` and `metadata.maximum` say what is expected.</td>
      <td>Create, List, Update, Actions</td>
      <td>PAN `ABC123`, a phone without +91 or a code of 5 digits.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_option`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `validation`</td>
      <td>A value is not one of the allowed options. `metadata.allowed_values` lists them when the list is short.</td>
      <td>Create, List, Update, Actions, Upload, List documents</td>
      <td>`business_type: "company"`, or action `send_sms_otp`.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`invalid_request`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `validation`</td>
      <td>The body is not valid JSON, a required field is missing or a key is not one the operation takes. An example is a misspelled or read-only field.</td>
      <td>Create, List, Update, Actions, Upload</td>
      <td>Leave out `user` when creating an account. Send `verification` in an update.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`missing_header`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `validation`</td>
      <td>A required header is missing or malformed. `metadata.header` names it.</td>
      <td>Create, Update, Actions, Upload</td>
      <td>Leave out `X-Idempotency-Key` on a write.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`password_protected_file`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `document_upload`</td>
      <td>The file is password protected.</td>
      <td>Upload</td>
      <td>A password-protected PDF.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`step_not_due`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `validation`</td>
      <td>The value or action is not due, yet or at all, such as a bank account before the business type. `metadata.due` lists what is due. Send only what the requirements list to avoid it.</td>
      <td>Update, Actions</td>
      <td>A bank account before the business type.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`400`</td>
      <td>`idempotency_key_reused`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `null`</td>
      <td>This `X-Idempotency-Key` was used in the last 24 h with a different body or file. Send a new key for a different request.</td>
      <td>Create, Update, Actions, Upload</td>
      <td>The same key with a different body.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`401`</td>
      <td>`invalid_credentials`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `authentication`</td>
      <td>The `Authorization` header is missing or is not Basic, or the key is not a partner key. It also fires when the secret is wrong, was revoked or is past its rotation window.</td>
      <td>Create, List, Fetch, Update, Actions, Upload, List documents, Fetch document, Delete document</td>
      <td>A wrong secret.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`403`</td>
      <td>`consent_withdrawn`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `authentication`</td>
      <td>The sub-merchant withdrew, through Razorpay, the platform's permission to act on the account. The call never succeeds again for this platform.</td>
      <td>Fetch, Update, Actions, Upload, List documents, Fetch document, Delete document</td>
      <td>Any call after settlement account `000000000007` withdraws access.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`403`</td>
      <td>`ip_not_allowed`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `authentication`</td>
      <td>A request came from an Internet Protocol (IP) address outside the app's allowlist for its mode. Test mode checks it once the test-mode allowlist has an entry.</td>
      <td>Create, List, Fetch, Update, Actions, Upload, List documents, Fetch document, Delete document</td>
      <td>A call from outside your app's test-mode allowlist.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`403`</td>
      <td>`onboarding_not_enabled`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `authentication`</td>
      <td>The app does not have the Onboarding APIs turned on in this mode, or Razorpay turned them off.</td>
      <td>Create, List, Fetch, Update, Actions, Upload, List documents, Fetch document, Delete document</td>
      <td>A test key pair from an app whose Onboarding APIs are off for test mode on the Partner Dashboard.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`404`</td>
      <td>`not_found`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `null`</td>
      <td>The resource does not exist, or the account is not mapped to the platform's app in this mode. Both look the same, so an ID cannot reveal who banks with Razorpay. `field` names the ID.</td>
      <td>Fetch, Update, Actions, Upload, List documents, Fetch document, Delete document</td>
      <td>`acc_DoesNotExist01`, or a deleted `file_` ID.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`409`</td>
      <td>`field_locked`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `null`</td>
      <td>The value cannot change in the product's current status. `field` names it, and `metadata.status` is the status that locks it.</td>
      <td>Update</td>
      <td>A new bank account while `edd_pending`.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`409`</td>
      <td>`idempotency_in_progress`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `null`</td>
      <td>A request with this `X-Idempotency-Key` is still running. Retry after `Retry-After`. The result is not stored until it finishes.</td>
      <td>Create, Update, Actions, Upload</td>
      <td>The same key sent twice at once.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`413`</td>
      <td>`file_too_large`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `document_upload`</td>
      <td>The file is larger than 20 MB. `metadata.max_bytes` is the limit.</td>
      <td>Upload</td>
      <td>A 21 MB file.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`415`</td>
      <td>`unsupported_media_type`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `document_upload`</td>
      <td>The file is not a PDF, JPEG or PNG, read from its bytes. `metadata.detected_type` is what was found.</td>
      <td>Upload</td>
      <td>A `.heic` file.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`429`</td>
      <td>`rate_limited`</td>
      <td>`BAD_REQUEST_ERROR`\
      `business`\
      `null`</td>
      <td>The app sent more requests than its rate limit. Retry after `Retry-After`.</td>
      <td>Create, List, Fetch, Update, Actions, Upload, List documents, Fetch document, Delete document</td>
      <td>6 sends of one action in an hour. Your app's overall limit is live only.</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`500`</td>
      <td>`internal_error`</td>
      <td>`SERVER_ERROR`\
      `internal`\
      `null`</td>
      <td>A problem inside Razorpay. Retry the call. A write retried with the same `X-Idempotency-Key` does not act twice.</td>
      <td>Create, List, Fetch, Update, Actions, Upload, List documents, Fetch document, Delete document</td>
      <td>None. A server error cannot be forced in test mode.</td>
      <td>Live only</td>
    </tr>

    <tr>
      <td>`503`</td>
      <td>`provider_unavailable`</td>
      <td>`SERVER_ERROR`\
      `verification_provider`\
      `ckyc_otp`</td>
      <td>A registry, bank or SMS or email provider that an action calls did not answer. Nothing ran and the request is fine, so retry after `Retry-After`. Checks inside an update never fail the call this way.</td>
      <td>Actions</td>
      <td>`send_ckyc_otp` for PAN `ABCPD1234W`.</td>
      <td>Available</td>
    </tr>
  </tbody>
</table>

## 2. Failed Checks

A failed check returns `200`. The element's `verification.status` is `rejected`, with the code below in `verification.error_code`. The description below is in `verification.error_description`, and the requirement comes back due. Branch on the code and show the description, which can change.

The last 4 codes are for links, which have no element to carry a code. The action stays due, and you run it again for a new link.

The table below lists every failed check code:

<table>
  <colgroup>
    <col width="14%" />

    <col width="8%" />

    <col width="18%" />

    <col width="20%" />

    <col width="18%" />

    <col width="14%" />

    <col width="8%" />
  </colgroup>

  <thead><tr><th>verification.error\_code</th><th>Check</th><th>When</th><th>Description</th><th>What is due next</th><th>Test value</th><th>Test mode</th></tr></thead>

  <tbody>
    <tr>
      <td>`pan_not_found`</td>
      <td>PAN</td>
      <td>The PAN registry has no such PAN, or rejected it as invalid.</td>
      <td>`We couldn't find this PAN. Check the number, or upload the PAN card.`</td>
      <td>The PAN again, or the PAN card, as the options of one composite requirement.</td>
      <td>`ABCPD1234K`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`pan_name_mismatch`</td>
      <td>PAN</td>
      <td>The PAN exists, but its holder is not the signatory named for the company.</td>
      <td>`This PAN belongs to someone other than the signatory. Send the signatory's own PAN.`</td>
      <td>The signatory's name and PAN again.</td>
      <td>Name `Rohan Kulkarni` with PAN `AANPI2846K`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`pan_check_unavailable`</td>
      <td>PAN</td>
      <td>The PAN registry did not answer, or answered with an error. The PAN itself is fine.</td>
      <td>`We couldn't check this PAN at the moment. Upload the PAN card instead.`</td>
      <td>The PAN card, or the PAN again later.</td>
      <td>`ABCPD1234D`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`promoter_underage`</td>
      <td>PAN</td>
      <td>The PAN holder is under 18.</td>
      <td>`Based on the date of birth linked to this PAN, you must be 18 years or older to register with Razorpay. If you believe this is an error, contact Razorpay support.`</td>
      <td>Nothing the platform sends clears it. The sub-merchant contacts Razorpay.</td>
      <td>`ABCPD1234M`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`pan_card_mismatch`</td>
      <td>PAN card</td>
      <td>The PAN printed on the card is not the PAN sent.</td>
      <td>`The PAN on this card doesn't match the PAN you entered. Upload the card for that PAN.`</td>
      <td>The PAN card again.</td>
      <td>`PERSONALPANMISMATCHFRONT.jpg`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`pan_card_name_mismatch`</td>
      <td>PAN card</td>
      <td>The name on the card is not the owner's or signatory's.</td>
      <td>`The name on this PAN card doesn't match. Upload your own PAN card.`</td>
      <td>The PAN card again.</td>
      <td>`PERSONALPANNAMEMISMATCHFRONT.jpg`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`pan_card_name_unreadable`</td>
      <td>PAN card</td>
      <td>No name or number could be read on the card.</td>
      <td>`We couldn't read this PAN card. Upload a clear photo or scan of the front.`</td>
      <td>The PAN card again.</td>
      <td>`PERSONALPANUNREADABLEFRONT.jpg`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`not_a_pan_card`</td>
      <td>PAN card</td>
      <td>The file is not a PAN card.</td>
      <td>`This doesn't look like a PAN card. Upload the front of your PAN card.`</td>
      <td>The PAN card again.</td>
      <td>`WRONGFRONT.jpg`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`otp_invalid`</td>
      <td>Central KYC Records Registry (CKYC) code</td>
      <td>The CKYC code does not match the one sent.</td>
      <td>`The code didn't match. Try again, or request a new code.`</td>
      <td>The corrected code with the same request ID. `ckyc_otp` and `ckyc_request_id` stay due.</td>
      <td>PAN `ABCPD1234A`, then code `000000`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`otp_expired`</td>
      <td>CKYC code</td>
      <td>The CKYC code was right but has expired, or a wrong code was tried 3 times.</td>
      <td>`This code has expired. Request a new code.`</td>
      <td>`send_ckyc_otp` again for a new code. The send action is due again.</td>
      <td>PAN `AICPD1234U`, then any code other than `000000`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`ckyc_unavailable`</td>
      <td>CKYC</td>
      <td>The CKYC record could not be downloaded, for a system reason.</td>
      <td>`We couldn't fetch your KYC record. Upload a proof of address instead.`</td>
      <td>The proof of address (Aadhaar, passport or voter ID).</td>
      <td>PAN `ABCPD1234X`, then any code other than `000000`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`poa_name_mismatch`</td>
      <td>Proof of address</td>
      <td>The address proof is not in the person's name.</td>
      <td>`The name on this document doesn't match. Upload an address proof in your own name.`</td>
      <td>The proof of address again.</td>
      <td>`AADHARMISMATCHFRONT.jpg`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`poa_unreadable`</td>
      <td>Proof of address</td>
      <td>The address proof could not be read.</td>
      <td>`We couldn't read this document. Upload a clear photo or scan.`</td>
      <td>The proof of address again.</td>
      <td>`AADHAARUNREADABLEFRONT.jpg`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`bank_name_mismatch`</td>
      <td>Bank account</td>
      <td>The account holder's name does not match the PAN name or the business name.</td>
      <td>`The account must be in the name of your business. Please use a different account.`</td>
      <td>Another account, or a ₹1 UPI payment from it, as the options of one composite requirement.</td>
      <td>`2100000011`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`bank_details_incorrect`</td>
      <td>Bank account</td>
      <td>The account number or Indian Financial System Code (IFSC) is wrong.</td>
      <td>`The account number or IFSC is incorrect. Check the details and try again.`</td>
      <td>The account again, or a ₹1 UPI payment from it.</td>
      <td>`2100000040`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`bank_account_unusable`</td>
      <td>Bank account</td>
      <td>The bank reported the account as frozen, blocked, closed or Non-Resident External (NRE).</td>
      <td>`This account cannot receive payments. Please use a different bank account.`</td>
      <td>A different account, or a ₹1 UPI payment from one.</td>
      <td>`1234567892`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`bank_check_unavailable`</td>
      <td>Bank account</td>
      <td>The bank could not be reached. The account itself is fine.</td>
      <td>`We could not reach your bank to verify the account. Verify it with a ₹1 UPI payment from the account.`</td>
      <td>The `bank_account` composite requirement again: the account, or a ₹1 UPI payment from it.</td>
      <td>`2100000039`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`bank_not_verified`</td>
      <td>Bank account</td>
      <td>Any other failure. Razorpay does not say why.</td>
      <td>`We could not verify this account. Check the details and try again.`</td>
      <td>The account again, or a ₹1 UPI payment from it.</td>
      <td>`2100000031`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`gstin_name_mismatch`</td>
      <td>Goods and Services Tax Identification Number (GSTIN)</td>
      <td>The GSTIN is registered to another business.</td>
      <td>`This GSTIN is registered to a different business. Check the GSTIN, or send your Udyam number instead.`</td>
      <td>The GSTIN again, or the Udyam number.</td>
      <td>`27ABCPD7892C1Z5`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`gstin_not_found`</td>
      <td>GSTIN</td>
      <td>The Goods and Services Tax (GST) registry has no such GSTIN, or the GSTIN is cancelled.</td>
      <td>`We couldn't find this GSTIN. Check the number, or send your Udyam number instead.`</td>
      <td>The GSTIN again, or the Udyam number.</td>
      <td>`07AADCB1234M1ZX`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`udyam_name_mismatch`</td>
      <td>Udyam number</td>
      <td>The Udyam registration is in another business's name.</td>
      <td>`This Udyam number is registered to a different business. Check the number, or send your GSTIN instead.`</td>
      <td>The Udyam number again, or the GSTIN.</td>
      <td>`UDYAM-MH-19-0005005`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`udyam_not_found`</td>
      <td>Udyam number</td>
      <td>The Udyam registry has no such number.</td>
      <td>`We couldn't find this Udyam number. Check the number, or send your GSTIN instead.`</td>
      <td>The Udyam number again, or the GSTIN.</td>
      <td>`UDYAM-MH-19-0004750`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`website_unreachable`</td>
      <td>Website</td>
      <td>The website could not be opened, or is not live.</td>
      <td>`We couldn't open your website. Check that it's live, or share another one.`</td>
      <td>The website again.</td>
      <td>`https://www.kc-not-found.com`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`link_expired`</td>
      <td>Link</td>
      <td>The sub-merchant did not complete the step before `metadata.expires_at`.</td>
      <td>`This link has expired. Run the action again for a new link.`</td>
      <td>The action is due again. Run it for a new link.</td>
      <td>**Expire the link** on any hosted test page</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`video_kyc_failed`</td>
      <td>Video KYC</td>
      <td>The agent could not verify the person on the call. Examples are a face that did not match the PAN photo or a dropped call.</td>
      <td>`We couldn't complete your video KYC. Start a new call when you're ready.`</td>
      <td>The action is due again. Run it for a new call.</td>
      <td>**Unable to verify** on the video KYC test page</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`digilocker_failed`</td>
      <td>DigiLocker</td>
      <td>The sub-merchant declined to share the Aadhaar in DigiLocker, or DigiLocker returned no Aadhaar.</td>
      <td>`We didn't get your Aadhaar from DigiLocker. Try again, or upload a proof of address.`</td>
      <td>The action is due again. Run it for a new link, or send a proof of address document, another option of the same composite requirement.</td>
      <td>**Decline** on the DigiLocker test page</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`upi_payment_failed`</td>
      <td>UPI ₹1 payment</td>
      <td>The ₹1 payment did not come from an account in the business's or owner's name, or it failed.</td>
      <td>`We couldn't verify the account from this payment. Pay from an account in your business's name, or share the account details.`</td>
      <td>The action is due again. Run it for a new link, or send the account.</td>
      <td>**Pay from another person's account** on the UPI test page</td>
      <td>Available</td>
    </tr>
  </tbody>
</table>

## 3. Review Reasons

In `needs_clarification`, each flagged point comes back as a requirement with the reviewer's own wording in `description` and the reason in `requirement_reason`. These are the reasons a reviewer can flag, with the test value that raises each one.

The table below lists every review reason:

<table>
  <colgroup>
    <col width="18%" />

    <col width="14%" />

    <col width="18%" />

    <col width="22%" />

    <col width="20%" />

    <col width="8%" />
  </colgroup>

  <thead><tr><th>Reason</th><th>Requirement</th><th>When</th><th>Example description</th><th>Test value</th><th>Test mode</th></tr></thead>

  <tbody>
    <tr>
      <td>`bank_account_ownership_unconfirmed`</td>
      <td>`bank_account`</td>
      <td>The reviewer could not confirm the business or its owner holds the settlement account.</td>
      <td>`A reviewer couldn't confirm that the payout account is held in your name. Share an account in your name, pay ₹1 from it, or reply.`</td>
      <td>Settlement account `000000000003`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`website_no_products`</td>
      <td>`website`</td>
      <td>The website does not list products or prices.</td>
      <td>`The website doesn't list any products or prices yet. Share a website with your products and prices, or explain how customers will buy from you.`</td>
      <td>Website `https://www.kc-no-products.com`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`website_policies_missing`</td>
      <td>`website`</td>
      <td>The website has no refund, cancellation or contact policy.</td>
      <td>`The website needs refund, cancellation and contact details. Add them, or explain how customers reach you.`</td>
      <td>Website `https://www.kc-no-policies.com`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`business_proof_unclear`</td>
      <td>`proof_of_business`</td>
      <td>The registration document is unreadable, expired or in another name.</td>
      <td>`We couldn't confirm your business from this document. Upload a clear, current registration in the business's name.`</td>
      <td>A business proof file named `UNCLEAR_` plus the PAN, such as `UNCLEAR_AANPI2846K.pdf`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`address_proof_unclear`</td>
      <td>`proof_of_address_for_individual`</td>
      <td>The proof of address is unreadable, cropped or in another name.</td>
      <td>`We couldn't read your proof of address. Upload both sides of an Aadhaar, voter ID or passport in your name, or use DigiLocker.`</td>
      <td>An Aadhaar front named `AADHAARUNCLEARFRONT.jpg`</td>
      <td>Available</td>
    </tr>

    <tr>
      <td>`category_mismatch`</td>
      <td>None</td>
      <td>What the business sells does not match its category.</td>
      <td>`What your business sells doesn't match the category you chose. Pick the category that fits.`</td>
      <td>A Merchant Category Code (MCC) that does not match the website, such as `https://curlec.com` with MCC `5399`</td>
      <td>Available</td>
    </tr>
  </tbody>
</table>

## 4. Composite Requirements

A `composite` requirement answers one point with its `sub_requirements`, combined as its `fulfillment_criteria` says. Under `one_of`, answer one sub-requirement and the whole composite clears. Under `any_of`, answer at least one. Under `all_of`, answer every one.

A composite's `requirement_code` is one of the codes below. A stakeholder's requirement carries the same code. Its inputs' `field_path` names the stakeholder, such as `business_profile.stakeholders.per_V1kr4mSh4hQx2W.documents.aadhaar_front`.

The table below lists every composite requirement:

<table>
  <colgroup>
    <col width="18%" />

    <col width="30%" />

    <col width="10%" />

    <col width="42%" />
  </colgroup>

  <thead><tr><th>Code</th><th>Description</th><th>Fulfilment criteria</th><th>Sub-requirements</th></tr></thead>

  <tbody>
    <tr>
      <td>`ckyc_fetch`</td>
      <td>`The person's CKYC record, fetched with a code or skipped.`</td>
      <td>`one_of`</td>
      <td><ul><li>`skip_ckyc`: `business_profile.authorized_person.identity_numbers.individual_ckyc.is_skipped`</li><li>`send_ckyc_otp` (action)</li></ul></td>
    </tr>

    <tr>
      <td>`individual_pan`</td>
      <td>`The person's PAN: the number, or the PAN card.`</td>
      <td>`one_of`</td>
      <td><ul><li>`individual_pan_number`: `business_profile.authorized_person.identity_numbers.individual_pan`</li><li>`individual_pan_card`: `business_profile.authorized_person.documents.individual_pan_document`</li></ul></td>
    </tr>

    <tr>
      <td>`business_pan`</td>
      <td>`The business PAN: the number, or the PAN card.`</td>
      <td>`one_of`</td>
      <td><ul><li>`business_pan_number`: `business_profile.identity_numbers.business_pan`</li><li>`business_pan_card`: `business_profile.documents.business_pan`</li></ul></td>
    </tr>

    <tr>
      <td>`proof_of_address_for_individual`</td>
      <td>`Verify the proof of address for an individual. It can be done through one of the multiple ways.`</td>
      <td>`one_of`</td>
      <td><ul><li>`create_aadhaar_digilocker_link` (action)</li><li>`poa_via_document_upload` (`one_of`)<ul><li>`poa_via_aadhaar_documents` (`all_of`)<ul><li>`poa_aadhaar_front`: `business_profile.authorized_person.documents.aadhaar_front`</li><li>`poa_aadhaar_back`: `business_profile.authorized_person.documents.aadhaar_back`</li></ul></li><li>`poa_via_passport_documents` (`all_of`)<ul><li>`poa_passport_front`: `business_profile.authorized_person.documents.passport_front`</li><li>`poa_passport_back`: `business_profile.authorized_person.documents.passport_back`</li></ul></li><li>`poa_via_voter_id_documents` (`all_of`)<ul><li>`poa_voter_id_front`: `business_profile.authorized_person.documents.voter_id_front`</li><li>`poa_voter_id_back`: `business_profile.authorized_person.documents.voter_id_back`</li></ul></li></ul></li></ul></td>
    </tr>

    <tr>
      <td>`business_identity`</td>
      <td>`The company's identity: the CIN or the certificate of incorporation.`\
      For a private limited, public limited or Section 8 company.</td>
      <td>`one_of`</td>
      <td><ul><li>`cin`: `business_profile.identity_numbers.cin`</li><li>`certificate_of_incorporation`: `business_profile.documents.certificate_of_incorporation`</li></ul></td>
    </tr>

    <tr>
      <td>`proof_of_business`</td>
      <td>`Proof that your business exists: one registration document and one registration number.`\
      For a proprietorship.</td>
      <td>`all_of`</td>
      <td><ul><li>`proof_of_business_document` (`one_of`)<ul><li>`gst_certificate`: `business_profile.documents.gst_certificate`</li><li>`udyam_registration_certificate`: `business_profile.documents.udyam_registration_certificate`</li><li>`shop_establishment`: `business_profile.documents.shop_establishment`</li></ul></li><li>`proof_of_business_number` (`one_of`)<ul><li>`gstin`: `business_profile.identity_numbers.gstin`</li><li>`udyam_registration`: `business_profile.identity_numbers.udyam_registration`</li></ul></li></ul></td>
    </tr>

    <tr>
      <td>`bank_account`</td>
      <td>`Your settlement bank account.`\
      Listed only after a failed check or in `needs_clarification`. `clarify_bank_account` appears only in `needs_clarification`. Otherwise the requirement is listed as `settlement_bank_account`.</td>
      <td>`one_of`</td>
      <td><ul><li>`settlement_bank_account` (`all_of`)<ul><li>`bank_account_number`: `bank_accounts.settlements_primary.account_number`</li><li>`bank_routing_code`: `bank_accounts.settlements_primary.routing_code`</li><li>`bank_routing_code_type`: `bank_accounts.settlements_primary.routing_code_type`</li></ul></li><li>`create_upi_link` (action)</li><li>`clarify_bank_account`: `products.payment_gateway.clarification_responses.bank_accounts.settlements_primary`</li></ul></td>
    </tr>

    <tr>
      <td>`settlement_bank_account`</td>
      <td>`The bank account that receives settlements, in the name on your PAN.`</td>
      <td>`all_of`</td>
      <td><ul><li>`bank_account_number`: `bank_accounts.settlements_primary.account_number`</li><li>`bank_routing_code`: `bank_accounts.settlements_primary.routing_code`</li><li>`bank_routing_code_type`: `bank_accounts.settlements_primary.routing_code_type`</li></ul></td>
    </tr>

    <tr>
      <td>`website`</td>
      <td>`Your website.`\
      Listed only in `needs_clarification`. Otherwise the requirement is listed as `website_url`.</td>
      <td>`one_of`</td>
      <td><ul><li>`website_url`: `products.payment_gateway.payment_channels.website.primary`</li><li>`clarify_website`: `products.payment_gateway.clarification_responses.products.payment_gateway.payment_channels.website.primary`</li></ul></td>
    </tr>

    <tr>
      <td>`payment_channels`</td>
      <td>`Where you take payments: a website, an Android app or an iOS app. Any one is enough.`\
      Optional. Any one channel answers it.</td>
      <td>`one_of`</td>
      <td><ul><li>`website_url`: `products.payment_gateway.payment_channels.website.primary`</li><li>`app_android_url`: `products.payment_gateway.payment_channels.app_android.url`</li><li>`app_ios_url`: `products.payment_gateway.payment_channels.app_ios.url`</li></ul></td>
    </tr>

    <tr>
      <td>`accept_terms_of_service`</td>
      <td>`Show the sub-merchant Razorpay's terms of service and record their acceptance.`\
      Sending it submits the product.</td>
      <td>`all_of`</td>
      <td><ul><li>`acceptance_ip`: `products.payment_gateway.terms_of_service_acceptance.ip`</li><li>`acceptance_device_fingerprint_id`: `products.payment_gateway.terms_of_service_acceptance.device_fingerprint_id`</li></ul></td>
    </tr>

    <tr>
      <td>`business_model_clarifications`</td>
      <td>`Answer the questions about your business model.`\
      One input per question, coded by the question ID. Its `value_type` comes from `bmc_input_type`: `single_select` becomes `enum`, `multi_select` stays `multi_select` and `free_text` becomes `text`. Each input carries the question's `options`.</td>
      <td>`all_of`</td>
      <td><ul><li>`<question_id>`: `business_profile.business_category.business_model_clarifications.<question_id>.answer`</li></ul></td>
    </tr>

    <tr>
      <td>`registered_address`</td>
      <td>`Your business's registered address.`</td>
      <td>`all_of`</td>
      <td><ul><li>`address_line1`: `business_profile.addresses[type=registered_address].line1`</li><li>`address_line2`: `business_profile.addresses[type=registered_address].line2`</li><li>`address_city`: `business_profile.addresses[type=registered_address].city`</li><li>`address_state`: `business_profile.addresses[type=registered_address].state`</li><li>`address_postal_code`: `business_profile.addresses[type=registered_address].postal_code`</li><li>`address_country`: `business_profile.addresses[type=registered_address].country`</li></ul></td>
    </tr>

    <tr>
      <td>`operational_address`</td>
      <td>`The address your business operates from.`</td>
      <td>`all_of`</td>
      <td><ul><li>`address_line1`: `business_profile.addresses[type=operational_address].line1`</li><li>`address_line2`: `business_profile.addresses[type=operational_address].line2`</li><li>`address_city`: `business_profile.addresses[type=operational_address].city`</li><li>`address_state`: `business_profile.addresses[type=operational_address].state`</li><li>`address_postal_code`: `business_profile.addresses[type=operational_address].postal_code`</li><li>`address_country`: `business_profile.addresses[type=operational_address].country`</li></ul></td>
    </tr>

    <tr>
      <td>`authorized_person`</td>
      <td>`The authorized person: their name and PAN.`</td>
      <td>`all_of`</td>
      <td><ul><li>`authorized_person_name`: `business_profile.authorized_person.name`</li><li>`individual_pan` (`one_of`)<ul><li>`individual_pan_number`: `business_profile.authorized_person.identity_numbers.individual_pan`</li><li>`individual_pan_card`: `business_profile.authorized_person.documents.individual_pan_document`</li></ul></li></ul></td>
    </tr>
  </tbody>
</table>

### Related Information

* [Test Your Integration](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration)
* [Individual](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/individual.md)
* [Proprietorship](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/proprietorship.md)
* [Private Limited](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/private-limited.md)
* [Public Limited](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/public-limited.md)
* [Other Business Types](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/other-business-types.md)
* [Test Values](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/test-values.md)
* [Create an Account](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/create-account.md)
* [Documents](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/documents.md)
* [Actions](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/actions.md)
* [Terms and Submission](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/terms-and-submission.md)
* [Onboarding API Errors](https://razorpay.com/docs/api/partners/accounts/errors.md)
