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

# Individual Tests

> Test individual onboarding on Onboarding APIs in Test Mode, including PAN, CKYC and bank verification scenarios.

Available in
🇮🇳 India

An individual is an unregistered business. The owner's PAN is the business identity, and the business name comes from the PAN. This page tests an individual's onboarding from account creation to activation, including the Central KYC Records Registry (CKYC) fetch and video KYC.

Before you start, check that your test credentials and headers work. See [Test Your Integration](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration). Every request and response body is on the API test pages, starting with [Create an Account](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/create-account.md).

## 1. Test Mode Coverage

### Test Mode Differences

The table below compares live mode and test mode for this business type:

| Behaviour | Live mode | Test mode |
| - | - | - |
| PAN and CKYC | The PAN registry confirms the PAN and returns its holder name. The CKYC registry says whether the person has a record. | The PAN you send decides both outcomes, from the [Test Values](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/test-values.md). We return the test business name and match it against the bank account for real. |
| Bank account | A penny drop to the account returns the holder name, which must match the name on the PAN. | The account number decides the outcome. The name match runs for real, so use the bank account from the same test business. |
| Phone and email codes | We send a 6-digit code by SMS and email when you run `send_phone_otp` or `send_email_otp`. The sub-merchant types it into your form. | We send no SMS or email. The action responds as in live mode. The code `000007` verifies. Any other 6 digits is a wrong code. Test mode cannot show whether your sub-merchants receive the messages. |
| The CKYC code | If the person's PAN has a CKYC record, `send_ckyc_otp` sends a code to that record's mobile number. The code fetches the record. | The PAN in the test business decides whether a record exists. We do not send the code. Any 6 digits other than `000000` verifies it. |
| Review after submission | We activate most products at submission. Some go to a Razorpay reviewer, which can take hours or days. The product can stay `under_review` the whole time. | No reviewer is involved. The settlement account picks the outcome, because an individual sends no business name. A review outcome lands about 5 sec after submission. A test value that holds the review takes 5 min. One that acts after activation takes 60 sec. Do not size your timeouts or sub-merchant messaging from these timings. |
| Video KYC | The sub-merchant joins a short video call with a Razorpay agent at the link that `create_video_kyc_link` returns. | The link opens a hosted test page where you pick the call outcome: **Approved**, **Rejected** or **Unable to verify**. No camera or agent is involved. |
| DigiLocker and the ₹1 UPI link | The sub-merchant shares their Aadhaar in DigiLocker at the link the action returns. For the UPI link, they pay ₹1 from the bank account. | The link opens a hosted test page where you pick the outcome. No sign-in or payment is involved. |
| Status webhooks | We send an event when a product moves to `under_review`, `edd_pending`, `needs_clarification`, `activated`, `rejected` or `suspended`. We also send one when requirements change without a call from you, such as an `in_progress` check that settles later. | The same events go to your test mode webhook URL with `mode: test`, a few seconds after each change. |

### What You Can Test

The table below lists what this page tests:

| Area | What to test |
| - | - |
| Activation | The whole journey from account creation to `activated`: scenario 1 step by step and scenario 2 in one call. |
| Video KYC | `edd_pending` to `activated`, plus a call that does not verify: scenarios 3 and 30. |
| Failed checks | PAN, PAN card, proof of address, CKYC, bank account and website. Each has a test value in [3.3 Error Scenarios](#3-3-error-scenarios). |
| Rejection, clarification and review | With the outcome accounts: scenarios 5, 32 and 33. |
| Links | DigiLocker, the ₹1 UPI link and an expired link, on the hosted test pages: scenarios 36, 37 and 35. |

### Endpoint Coverage in Test Mode

The table below lists the endpoints this business type uses:

| API | Endpoint | Available in test mode |
| - | - | - |
| Create an account | [`POST /v1/accounts`](https://razorpay.com/docs/api/partners/accounts/create) | Available |
| Fetch one account | [`GET /v1/accounts/{account_id}`](https://razorpay.com/docs/api/partners/accounts/fetch) | Available |
| Update an account | [`PATCH /v1/accounts/{account_id}`](https://razorpay.com/docs/api/partners/accounts/update) | Available |
| Send the phone and email codes | [`POST /v1/accounts/{account_id}/actions/send_phone_otp`](https://razorpay.com/docs/api/partners/accounts/run-action) and `…/send_email_otp` | Available |
| Send the CKYC code | [`POST /v1/accounts/{account_id}/actions/send_ckyc_otp`](https://razorpay.com/docs/api/partners/accounts/run-action) | Available |
| Create the video KYC link | [`POST /v1/accounts/{account_id}/actions/create_video_kyc_link`](https://razorpay.com/docs/api/partners/accounts/run-action) | Available |
| Create a DigiLocker link | [`POST /v1/accounts/{account_id}/actions/create_aadhaar_digilocker_link`](https://razorpay.com/docs/api/partners/accounts/run-action) | Available |
| Create a ₹1 UPI link | [`POST /v1/accounts/{account_id}/actions/create_upi_link`](https://razorpay.com/docs/api/partners/accounts/run-action) | Available |
| Upload a document | [`POST /v1/accounts/{account_id}/documents`](https://razorpay.com/docs/api/partners/accounts/upload-document) | Available |
| Accept the terms and submit | [`PATCH /v1/accounts/{account_id}`](https://razorpay.com/docs/api/partners/accounts/update) with `products.payment_gateway.terms_of_service_acceptance` | Available |

### Webhooks

An onboarding fires the events below. Test mode accounts send them to your test mode webhook URL.

The table below lists each webhook and what to do when it arrives:

| Webhook | Fires when and what to do | In test mode |
| - | - | - |
| `account.product.under_review` | A product was submitted, its video KYC call finished or it was resubmitted after a clarification. Lock the KYC details in your app. | Available |
| `account.product.edd_pending` | The product needs video KYC before review continues. Show the video KYC link. | Available |
| `account.product.needs_clarification` | A reviewer flagged points. Fetch the account and show only those points. | Available |
| `account.product.activated` | The product is live. Turn on payments for the shop. | Available |
| `account.product.rejected` | The application was not approved. Stop offering changes. | Available |
| `account.product.suspended` | An activated product was suspended, and `status_reason` says why. Stop payments and ask for what `requirements` lists. | Available |
| `account.requirements.updated` | Requirements changed without a call from you. A check finished after the response, or the sub-merchant completed a step at a link. Fetch the account and render the requirements again. | Available |
| `account.consent.withdrawn` | The sub-merchant withdrew your access through Razorpay. Stop calling the API for the account. | Available |

### Webhooks Each Scenario Fires

The table below lists the webhooks that key scenarios fire:

| Scenario | Webhooks | In test mode |
| - | - | - |
| 1: Activated | `account.requirements.updated` (as the website check settles), `account.product.activated` | Available |
| 3: Video KYC | `account.requirements.updated` (as the website check settles), `account.product.edd_pending`, `account.requirements.updated`, `account.product.under_review`, `account.product.activated` | Available |
| 5: Rejected | `account.requirements.updated` (as the website check settles), `account.product.under_review`, `account.product.rejected` | Available |
| A failed check | None, because the response carries it. The website check fires `account.requirements.updated`. | Available |

### Before You Trust a Webhook

Follow these rules before you act on any webhook:

* **Verify the signature** on the raw body with your webhook secret before you parse it. Reject anything that fails.
* **Expect repeats.** An event can arrive more than once. Use `X-Razorpay-Event-Id` to process each event once.
* **Expect events out of order.** Compare `payload.account.updated_at`, or fetch the account and act on its current status.
* **Do not wait on webhooks.** The payload carries only what changed: the complete product, with its status and requirements. Fetch the account for the rest, and fetch when an event is late.

### Product Statuses

Take payments only while the product is `activated`. Every status is reachable in test mode.

The table below lists the product statuses:

| Status | Means | Accepts payments | Webhook | Available in test mode |
| - | - | - | - | - |
| `created` | The product is on the account | No | None | Available |
| `in_progress` | Values are coming in. `requirements` lists what is left | No | None | Available |
| `under_review` | Submitted for Razorpay review | No | `account.product.under_review` | Available |
| `edd_pending` | Submitted with video KYC due | No | `account.product.edd_pending` | Available |
| `needs_clarification` | A reviewer flagged points to answer | No | `account.product.needs_clarification` | Available |
| `activated` | Live | Yes, in live mode | `account.product.activated` | Available |
| `rejected` | Not approved, with no further changes | No | `account.product.rejected` | Available |
| `suspended` | Stopped after being live | No | `account.product.suspended` | Available |

## 2. Before You Begin

Set up the following before you start:

* Generate your app's **test** key and secret pair on the Partner Dashboard. The test pair sends every request to test mode. Its key starts with `rzp_test_partner_`.
* Use the same endpoints and request bodies as in live mode. Only the key changes. Every write carries an `X-Idempotency-Key` header.
* Send each input's value at its `field_path`, in the order that `requirements` lists them.
* Subscribe a test mode webhook URL on the Partner Dashboard to receive each scenario's webhooks.

No registry or bank sits on the other end, so the value you send decides each check outcome. We match names for real, so take every value from one test business.

For example, send PAN `ABCPD1234A` and it verifies with the name `Rzp Test QA Merchant`, with `ckyc_fetch` due. Send `ABCPD1234K` and the PAN `verification` is `rejected` with `pan_not_found`.

Keep these rules in mind when you pick values:

* **To succeed**, use test business A or C.
* **To fail a check**, send one of the values in [3.3 Error Scenarios](#3-3-error-scenarios).
* **You need no real details.** Nothing reaches a registry, a bank or the sub-merchant. Skip the real PAN, bank account, phone and video call.
* **Any other value** fails as if the registry or bank were down, so a typo looks like an outage.

### Test Businesses

Every individual test business uses the Indian Financial System Code (IFSC) `HDFC0123456` for its bank account.

The table below lists the individual test businesses:

| Value | A: CKYC found | B: no CKYC | C: CKYC found | D: no CKYC |
| - | - | - | - | - |
| Name (from the PAN) | `Rzp Test QA Merchant` | `Rzp Test QA Merchant` | `Rohan Kulkarni` | `Zoya Qureshi` |
| PAN | `ABCPD1234A` | `ABCPD7891B` | `ROHPK5163M` | `ZOYPQ7428D` |
| CKYC | Found, so `ckyc_fetch` is due | Not found, so video KYC follows submission | Found | Not found |
| Bank account | `1234567890` | `1234567890` | `5566770004` | `5566770005` |
| Aadhaar files | `AADHAARCKYCCOMPLETE.jpg` | `AADHAARCKYCCOMPLETE.jpg` | `AADHARFRONT_ROHPK5163M.jpg`, `AADHARBACK_ROHPK5163M.jpg` | `AADHARFRONT_ZOYPQ7428D.jpg`, `AADHARBACK_ZOYPQ7428D.jpg` |
| Outcome after submission | `activated` | `edd_pending`, then video KYC | `activated` | `edd_pending`, then video KYC |

Every individual also uses these values:

* Phone and email codes: `000007`.
* CKYC code: any 6 digits other than `000000`.
* Website: `https://curlec.com` with Merchant Category Code (MCC) `5732`.
* Statement descriptor (`statement_descriptor.value`): any value.
* Business-model questions: any option for each question.

To pick another outcome, send one of the [outcome accounts](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/test-values.md#3-after-submission) as the settlement account instead.

## 3. Test Scenarios

This section lists every scenario to run against your integration for this business type before you go live. We group the scenarios by what each one proves. Work down the page in order to cover the integration end to end.

The scenarios fall into 4 groups:

* **Must-build**: The successful path and the outcomes you are almost certain to meet once live. Run these first.
* **Other common scenarios**: Scenarios shared with the other business types, so the same handling must work on every one.
* **Error scenarios**: Failed checks you trigger with a test value, so you check your handling without waiting for a real failure.
* **Review, links and after activation**: Outcomes that a reviewer, a hosted link or a later change decides. Test values and the hosted test pages force each one.

Each scenario's steps end with the webhooks it fires and the status it leaves. In test mode, the webhooks go to your test mode webhook URL.

### 3.1 Must-Build Scenarios

**Live** scenarios work in test mode today. **Coming soon** scenarios are not available in test mode yet.

The table below lists the must-build scenarios:

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

    <col width="20%" />

    <col width="20%" />

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

  <thead><tr><th>#</th><th>Scenario</th><th>Trigger</th><th>What to confirm</th></tr></thead>

  <tbody>
    <tr>
      <td>1</td>
      <td>Activated end to end Coming soon</td>
      <td>Test business A, step by step</td>

      <td>
        <ol>
          <li>Create the account with `country`, the user and `products: { "payment_gateway": { "payment_channels": {} } }`. See [Create an Account](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/create-account.md). Confirm `business_type`, `send_phone_otp` and `send_email_otp` are due.</li>
          <li>Run `send_phone_otp` and `send_email_otp`, then send `000007` as `phone_otp` and `email_otp`.</li>
          <li>Send `business_type: individual`, then the PAN `ABCPD1234A` at `business_profile.authorized_person.identity_numbers.individual_pan`.</li>
          <li>Confirm the PAN is `verified` with the name `Rzp Test QA Merchant`, and `ckyc_fetch` is due as `send_ckyc_otp` or `skip_ckyc`.</li>
          <li>Run `send_ckyc_otp`. Confirm its `metadata` has a `request_id` and its `requirements` list `ckyc_otp` and `ckyc_request_id`.</li>
          <li>Send any 6 digits other than `000000` as `individual_ckyc.otp`, with that request ID as `individual_ckyc.request_id`. Confirm `individual_ckyc` is `verified` and no proof of address is due.</li>
          <li>If `requirements` lists `registered_address` or `operational_address`, send them under `business_profile.addresses`. Each is `all_of` its lines, city, state, postal code and country. Otherwise a CKYC record, DigiLocker or a Goods and Services Tax (GST) record fills them.</li>
          <li>Send bank account `1234567890` with IFSC `HDFC0123456` under `bank_accounts.settlements_primary`. Confirm it is `verified`.</li>
          <li>Send the category `ecommerce` with the subcategory `computers_peripheral_equipment_software` (MCC `5732`) and a description.</li>
          <li>Send the website `https://curlec.com` and a statement descriptor at `statement_descriptor.value`.</li>
          <li>The test category, `computers_peripheral_equipment_software`, asks no business-model questions. To test them, see scenario 8 on [Update an Account](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/update-account.md).</li>
          <li>Show Razorpay's terms of service to the sub-merchant. Then send the sub-merchant's `ip` and `device_fingerprint_id` in `products.payment_gateway.terms_of_service_acceptance`. See [Terms and Submission](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/terms-and-submission.md).</li>
          <li>Confirm the response is `activated`.</li>
          <li>Webhooks received: `account.requirements.updated` (as the website check settles), `account.product.activated`.</li>
          <li>Status changes: `in_progress` → `activated`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>2</td>
      <td>Create everything at once Coming soon</td>
      <td>Test business A in one account creation call</td>

      <td>
        <ol>
          <li>Send the one-shot request on [Create an Account](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/create-account.md). It uses the values of test business A.</li>
          <li>Confirm `201`, with the PAN and the bank account `verified` and the website `in_progress`.</li>
          <li>Confirm `requirements` lists `ckyc_fetch` and `accept_terms_of_service`.</li>
          <li>Run `send_ckyc_otp` and send the code with its request ID. Answer the questions and accept the terms.</li>
          <li>Webhooks received: `account.requirements.updated` (as the website check settles), `account.product.activated`.</li>
          <li>Status changes: `in_progress` → `activated`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>3</td>
      <td>No CKYC record: video KYC Coming soon</td>
      <td>Test business B</td>

      <td>
        <ol>
          <li>Run scenario 1 with PAN `ABCPD7891B`. Confirm `ckyc_fetch` is not due and `proof_of_address_for_individual` is.</li>
          <li>Send `AADHAARCKYCCOMPLETE.jpg` as both `aadhaar_front` and `aadhaar_back` in one update. `poa_via_aadhaar_documents` is an `all_of` pair, so the composite clears.</li>
          <li>Accept the terms. Confirm the response is `edd_pending`, with `create_video_kyc_link` due as an `action`.</li>
          <li>Run `create_video_kyc_link`. The link is in its response `metadata`, and the action stays due.</li>
          <li>Open the `url` and pick **Approved**.</li>
          <li>Fetch the account after 5 sec. Confirm `activated`.</li>
          <li>Webhooks received: `account.requirements.updated` (as the website check settles), `account.product.edd_pending`, `account.requirements.updated`, `account.product.under_review`, `account.product.activated`.</li>
          <li>Status changes: `in_progress` → `edd_pending` → `under_review` → `activated`.</li>
        </ol>
      </td>
    </tr>
  </tbody>
</table>

### 3.2 Other Common Scenarios

The table below lists the other common scenarios:

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

    <col width="20%" />

    <col width="20%" />

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

  <thead><tr><th>#</th><th>Scenario</th><th>Trigger</th><th>What to confirm</th></tr></thead>

  <tbody>
    <tr>
      <td>4</td>
      <td>Fetch to follow the status (also on every business type) Coming soon</td>
      <td>Settlement account `000000000002`</td>

      <td>
        <ol>
          <li>Submit the account. Confirm the response is `under_review`.</li>
          <li>Poll `GET /v1/accounts/{account_id}` every 2 sec, for up to 60 sec.</li>
          <li>Confirm `rejected` arrives about 5 sec later, and that your code never treats `under_review` as final.</li>
          <li>Webhooks received: `account.requirements.updated` (as the website check settles), `account.product.under_review`, `account.product.rejected`.</li>
          <li>Status changes: `under_review` → `rejected`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>5</td>
      <td>Rejected (also on every business type) Coming soon</td>
      <td>Settlement account `000000000002`</td>

      <td>
        <ol>
          <li>Run scenario 1 with this settlement account.</li>
          <li>Confirm the response is `under_review`, then fetch the account after 5 sec. Confirm `rejected`.</li>
          <li>Confirm that later updates return `409 field_locked`.</li>
          <li>Webhooks received: `account.requirements.updated` (as the website check settles), `account.product.under_review`, `account.product.rejected`.</li>
          <li>Status changes: `under_review` → `rejected`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>6</td>
      <td>The PAN card instead of the number Coming soon</td>
      <td>`PERSONALPANFRONT.jpg`</td>

      <td>
        <ol>
          <li>Upload the file with `type: individual_pan_document`. See [Documents](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/documents.md).</li>
          <li>Attach its `id` at `business_profile.authorized_person.documents.individual_pan_document`.</li>
          <li>Confirm the card is `verified` and `individual_pan` cleared.</li>
          <li>Webhooks received: none.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>7</td>
      <td>Wrong codes 3 times Coming soon</td>
      <td>A wrong phone code, sent 3 times</td>

      <td>
        <ol>
          <li>Send a wrong `phone_otp` 3 times.</li>
          <li>Confirm `send_phone_otp` is due again as an action.</li>
          <li>Run it again and send the new code.</li>
          <li>Webhooks received: none.</li>
          <li>Status changes: none.</li>
        </ol>
      </td>
    </tr>
  </tbody>
</table>

### 3.3 Error Scenarios

We group the error scenarios by the check or request that fails. In the error object, `…authorized_person` stands for `business_profile.authorized_person`. `…website.primary` stands for `products.payment_gateway.payment_channels.website.primary`.

**PAN Registry**

The PAN registry said no, or did not answer. Most failures bring back `individual_pan` or `business_pan`, meaning the number or the card. Nothing you send fixes an under-18 holder.

The table below lists the PAN registry scenarios:

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

    <col width="17%" />

    <col width="16%" />

    <col width="25%" />

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

  <thead><tr><th>#</th><th>Scenario</th><th>Trigger</th><th>Error object</th><th>What to confirm</th></tr></thead>

  <tbody>
    <tr>
      <td>8</td>
      <td>PAN: the PAN is invalid Coming soon</td>
      <td>`ABCPD1234K`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `pan_not_found`\
      At: `…authorized_person.identity_numbers.individual_pan`\
      Due again: `…authorized_person.identity_numbers.individual_pan`, `…authorized_person.documents.individual_pan_document`\
      Composite requirement: `individual_pan`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>9</td>
      <td>PAN: no record exists for the PAN Coming soon</td>
      <td>`ABCPD1234C`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `pan_not_found`\
      At: `…authorized_person.identity_numbers.individual_pan`\
      Due again: `…authorized_person.identity_numbers.individual_pan`, `…authorized_person.documents.individual_pan_document`\
      Composite requirement: `individual_pan`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>10</td>
      <td>PAN: the registry errored, but the PAN is fine Coming soon</td>
      <td>`ABCPD1234D`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `pan_check_unavailable`\
      At: `…authorized_person.identity_numbers.individual_pan`\
      Due again: `…authorized_person.identity_numbers.individual_pan`, `…authorized_person.documents.individual_pan_document`\
      Composite requirement: `individual_pan`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>11</td>
      <td>PAN: the PAN holder is under 18 Coming soon</td>
      <td>`ABCPD1234M`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `promoter_underage`\
      At: `…authorized_person.identity_numbers.individual_pan`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>
  </tbody>
</table>

**Documents**

The file was unreadable, or did not match what was sent. Ask for the right file.

The table below lists the document scenarios:

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

    <col width="17%" />

    <col width="16%" />

    <col width="25%" />

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

  <thead><tr><th>#</th><th>Scenario</th><th>Trigger</th><th>Error object</th><th>What to confirm</th></tr></thead>

  <tbody>
    <tr>
      <td>12</td>
      <td>PAN card: the card reads `ABCPD1234Z`, not the PAN sent Coming soon</td>
      <td>`PERSONALPANMISMATCHFRONT.jpg`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `pan_card_mismatch`\
      At: `…authorized_person.documents.individual_pan_document`\
      Due again: `…authorized_person.documents.individual_pan_document`</td>

      <td>
        <ol>
          <li>Upload the file with its type and attach its `id` where it is due.</li>
          <li>Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>13</td>
      <td>PAN card: the card carries another name Coming soon</td>
      <td>`PERSONALPANNAMEMISMATCHFRONT.jpg`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `pan_card_name_mismatch`\
      At: `…authorized_person.documents.individual_pan_document`\
      Due again: `…authorized_person.documents.individual_pan_document`</td>

      <td>
        <ol>
          <li>Upload the file with its type and attach its `id` where it is due.</li>
          <li>Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>14</td>
      <td>PAN card: no name or number is readable on the card Coming soon</td>
      <td>`PERSONALPANUNREADABLEFRONT.jpg`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `pan_card_name_unreadable`\
      At: `…authorized_person.documents.individual_pan_document`\
      Due again: `…authorized_person.documents.individual_pan_document`</td>

      <td>
        <ol>
          <li>Upload the file with its type and attach its `id` where it is due.</li>
          <li>Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>15</td>
      <td>PAN card: the file is not a PAN card Coming soon</td>
      <td>`WRONGFRONT.jpg`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `not_a_pan_card`\
      At: `…authorized_person.documents.individual_pan_document`\
      Due again: `…authorized_person.documents.individual_pan_document`</td>

      <td>
        <ol>
          <li>Upload the file with its type and attach its `id` where it is due.</li>
          <li>Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>16</td>
      <td>Proof of address: the Aadhaar is in another name Coming soon</td>
      <td>`AADHARMISMATCHFRONT.jpg`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `poa_name_mismatch`\
      At: `…authorized_person.documents.aadhaar_front`\
      Due again: `create_aadhaar_digilocker_link`, `…authorized_person.documents.aadhaar_front`, `…authorized_person.documents.aadhaar_back`, `…authorized_person.documents.passport_front`, `…authorized_person.documents.passport_back`, `…authorized_person.documents.voter_id_front`, `…authorized_person.documents.voter_id_back`\
      Composite requirement: `proof_of_address_for_individual`</td>

      <td>
        <ol>
          <li>Upload the file with its type and attach its `id` where it is due.</li>
          <li>Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>17</td>
      <td>Proof of address: the Aadhaar is unreadable Coming soon</td>
      <td>`AADHAARUNREADABLEFRONT.jpg`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `poa_unreadable`\
      At: `…authorized_person.documents.aadhaar_front`\
      Due again: `create_aadhaar_digilocker_link`, `…authorized_person.documents.aadhaar_front`, `…authorized_person.documents.aadhaar_back`, `…authorized_person.documents.passport_front`, `…authorized_person.documents.passport_back`, `…authorized_person.documents.voter_id_front`, `…authorized_person.documents.voter_id_back`\
      Composite requirement: `proof_of_address_for_individual`</td>

      <td>
        <ol>
          <li>Upload the file with its type and attach its `id` where it is due.</li>
          <li>Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>
  </tbody>
</table>

**CKYC**

The CKYC record did not come through. After a wrong code, `ckyc_otp` and `ckyc_request_id` stay due. Send the right code with the same request ID. An expired code brings `send_ckyc_otp` back. A record that cannot be downloaded makes the proof of address due.

The table below lists the CKYC scenarios:

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

    <col width="17%" />

    <col width="16%" />

    <col width="25%" />

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

  <thead><tr><th>#</th><th>Scenario</th><th>Trigger</th><th>Error object</th><th>What to confirm</th></tr></thead>

  <tbody>
    <tr>
      <td>18</td>
      <td>CKYC record: the record cannot be downloaded Coming soon</td>
      <td>PAN `ABCPD1234X`, then any code other than `000000`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `ckyc_unavailable`\
      At: `…authorized_person.identity_numbers.individual_ckyc`\
      Due again: `create_aadhaar_digilocker_link`, `…authorized_person.documents.aadhaar_front`, `…authorized_person.documents.aadhaar_back`, `…authorized_person.documents.passport_front`, `…authorized_person.documents.passport_back`, `…authorized_person.documents.voter_id_front`, `…authorized_person.documents.voter_id_back`\
      Composite requirement: `proof_of_address_for_individual`</td>

      <td>
        <ol>
          <li>Send the PAN, run `send_ckyc_otp` and send the code shown.</li>
          <li>Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>19</td>
      <td>CKYC code: the code has expired Coming soon</td>
      <td>PAN `AICPD1234U`, then any code other than `000000`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `otp_expired`\
      At: `…authorized_person.identity_numbers.individual_ckyc`\
      Due again: `send_ckyc_otp`, `…authorized_person.identity_numbers.individual_ckyc.is_skipped`\
      Composite requirement: `ckyc_fetch`</td>

      <td>
        <ol>
          <li>Send the PAN, run `send_ckyc_otp` and send the code shown.</li>
          <li>Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>20</td>
      <td>CKYC code: the code does not match the one sent Coming soon</td>
      <td>PAN `ABCPD1234A`, then code `000000`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `otp_invalid`\
      At: `…authorized_person.identity_numbers.individual_ckyc`\
      Due again: `…authorized_person.identity_numbers.individual_ckyc.otp`, `…authorized_person.identity_numbers.individual_ckyc.request_id`</td>

      <td>
        <ol>
          <li>Send the PAN, run `send_ckyc_otp` and send the code shown.</li>
          <li>Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>
  </tbody>
</table>

**Bank**

The bank check failed. `bank_account` comes back as `one_of`: the same or another account (`settlement_bank_account`), or the ₹1 UPI link (`create_upi_link`). Show them as one choice.

The table below lists the bank scenarios:

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

    <col width="17%" />

    <col width="16%" />

    <col width="25%" />

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

  <thead><tr><th>#</th><th>Scenario</th><th>Trigger</th><th>Error object</th><th>What to confirm</th></tr></thead>

  <tbody>
    <tr>
      <td>21</td>
      <td>Bank account: the holder name does not match Coming soon</td>
      <td>`2100000011`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `bank_name_mismatch`\
      At: `bank_accounts.settlements_primary`\
      Due again: `bank_accounts.settlements_primary`, `create_upi_link`\
      Composite requirement: `bank_account`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>22</td>
      <td>Bank account: the holder name is close but under the match threshold Coming soon</td>
      <td>`2100000012`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `bank_name_mismatch`\
      At: `bank_accounts.settlements_primary`\
      Due again: `bank_accounts.settlements_primary`, `create_upi_link`\
      Composite requirement: `bank_account`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>23</td>
      <td>Bank account: the IFSC is invalid Coming soon</td>
      <td>`2100000040`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `bank_details_incorrect`\
      At: `bank_accounts.settlements_primary`\
      Due again: `bank_accounts.settlements_primary`, `create_upi_link`\
      Composite requirement: `bank_account`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>24</td>
      <td>Bank account: the account is closed Coming soon</td>
      <td>`1234567892`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `bank_account_unusable`\
      At: `bank_accounts.settlements_primary`\
      Due again: `bank_accounts.settlements_primary`, `create_upi_link`\
      Composite requirement: `bank_account`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>25</td>
      <td>Bank account: the account is frozen Coming soon</td>
      <td>`2100000005`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `bank_account_unusable`\
      At: `bank_accounts.settlements_primary`\
      Due again: `bank_accounts.settlements_primary`, `create_upi_link`\
      Composite requirement: `bank_account`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>26</td>
      <td>Bank account: a Non-Resident External (NRE) account cannot receive settlements Coming soon</td>
      <td>`2100000006`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `bank_account_unusable`\
      At: `bank_accounts.settlements_primary`\
      Due again: `bank_accounts.settlements_primary`, `create_upi_link`\
      Composite requirement: `bank_account`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>27</td>
      <td>Bank account: the bank was unreachable, but the account is fine Coming soon</td>
      <td>`2100000039`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `bank_check_unavailable`\
      At: `bank_accounts.settlements_primary`\
      Due again: `bank_accounts.settlements_primary`, `create_upi_link`\
      Composite requirement: `bank_account`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>28</td>
      <td>Bank account: the bank declined without a reason Coming soon</td>
      <td>`2100000031`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `bank_not_verified`\
      At: `bank_accounts.settlements_primary`\
      Due again: `bank_accounts.settlements_primary`, `create_upi_link`\
      Composite requirement: `bank_account`</td>

      <td>
        <ol>
          <li>Send the value where it is due. Confirm the response is a `200`.</li>
          <li>Webhooks received: none, because the response carries the failure.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>
  </tbody>
</table>

**Website**

The website check runs after the response, so the failure shows on the next fetch. Send the website again, or another one.

The table below lists the website scenario:

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

    <col width="17%" />

    <col width="16%" />

    <col width="25%" />

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

  <thead><tr><th>#</th><th>Scenario</th><th>Trigger</th><th>Error object</th><th>What to confirm</th></tr></thead>

  <tbody>
    <tr>
      <td>29</td>
      <td>Website: the check fails a few seconds after the response Coming soon</td>
      <td>`https://www.kc-not-found.com`</td>
      <td>`verification.status`: `rejected`\
      `verification.error_code`: `website_unreachable`\
      At: `…website.primary`\
      Due again: `…website.primary`</td>

      <td>
        <ol>
          <li>Send the website where it is due, and fetch the account after 5 sec.</li>
          <li>Webhooks received: `account.requirements.updated`.</li>
          <li>Status changes: none. The product stays `in_progress`.</li>
        </ol>
      </td>
    </tr>
  </tbody>
</table>

**Video KYC**

The call did not verify the person. The action is due again, so let the sub-merchant start a new call.

The table below lists the video KYC scenario:

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

    <col width="17%" />

    <col width="16%" />

    <col width="25%" />

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

  <thead><tr><th>#</th><th>Scenario</th><th>Trigger</th><th>Error object</th><th>What to confirm</th></tr></thead>

  <tbody>
    <tr>
      <td>30</td>
      <td>Video KYC not approved (also on every business type) Coming soon</td>
      <td>The hosted page's **Unable to verify**, or **Rejected**</td>
      <td>Still due: `create_video_kyc_link`\
      `requirement_type`: `action`</td>

      <td>
        <ol>
          <li>Submit a test business without a CKYC record, run `create_video_kyc_link` and open the `url`.</li>
          <li>Pick **Unable to verify**.</li>
          <li>Fetch the account. Confirm `create_video_kyc_link` is still due, and run it again for a new call.</li>
          <li>Pick **Rejected** on a new link instead. Confirm the product ends `rejected`.</li>
          <li>Webhooks received: none for **Unable to verify**, because the requirements do not change. For **Rejected**, `account.product.under_review` then `account.product.rejected`.</li>
          <li>Status changes: the product stays `edd_pending`, or moves `under_review` → `rejected`.</li>
        </ol>
      </td>
    </tr>
  </tbody>
</table>

**Request Errors**

The request itself was wrong, so nothing was saved and no webhook fires. Fix it in code, because retrying it unchanged fails again.

The table below lists the request error scenarios:

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

    <col width="17%" />

    <col width="16%" />

    <col width="25%" />

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

  <thead><tr><th>#</th><th>Scenario</th><th>Trigger</th><th>Error object</th><th>What to confirm</th></tr></thead>

  <tbody>
    <tr>
      <td>31</td>
      <td>Business name for an individual Live</td>
      <td>`business_name` in an update</td>
      <td>HTTP `400`\
      `error.reason`: `invalid_request`\
      `error.field`: `business_profile.business_name`</td>

      <td>
        <ol>
          <li>Send the update.</li>
          <li>Confirm `400`, because an individual's name comes from the PAN.</li>
          <li>Webhooks received: none.</li>
          <li>Status changes: none.</li>
        </ol>
      </td>
    </tr>
  </tbody>
</table>

Every failure code, with its test value, is in the [Error Index](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/error-index.md).

### 3.4 Review, Links and After Activation

A reviewer, a hosted link or a later change decides these outcomes. A test value or a hosted test page forces each one.

The table below lists the scenarios that a review, a link or a later change decides:

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

    <col width="20%" />

    <col width="20%" />

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

  <thead><tr><th>#</th><th>Scenario</th><th>Trigger</th><th>What to confirm</th></tr></thead>

  <tbody>
    <tr>
      <td>32</td>
      <td>Needs clarification (also on every business type) Coming soon</td>
      <td>Settlement account `000000000003`</td>

      <td>
        <ol>
          <li>Run scenario 1 with this settlement account, and submit.</li>
          <li>Fetch the account after 5 sec. Confirm `needs_clarification`, with only `bank_account` due.</li>
          <li>Answer the point. When `submit_clarification` is due, send `submit_clarification: true` in its own call. See [Needs Clarification](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/needs-clarification.md).</li>
          <li>Webhooks received: `account.requirements.updated` (as the website check settles), `account.product.under_review`, `account.product.needs_clarification`, `account.product.under_review`, `account.product.activated`.</li>
          <li>Status changes: `under_review` → `needs_clarification` → `under_review` → `activated`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>33</td>
      <td>Held in review (also on every business type) Coming soon</td>
      <td>Settlement account `000000000005`</td>

      <td>
        <ol>
          <li>Send the account. Confirm its `verification` is `deferred` and `bank_account` clears.</li>
          <li>Submit. Confirm the response is `under_review`.</li>
          <li>Confirm it stays `under_review` for 5 min, then becomes `activated`.</li>
          <li>Assert that no timeout in your code moves the sub-merchant to a failure state.</li>
          <li>Webhooks received: `account.requirements.updated` (as the website check settles), `account.product.under_review`, `account.product.activated`.</li>
          <li>Status changes: `under_review` → `activated`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>34</td>
      <td>Suspended after activation (also on every business type) Coming soon</td>
      <td>Settlement account `000000000006`</td>

      <td>
        <ol>
          <li>Run scenario 1 with this settlement account. Confirm the response is `activated`.</li>
          <li>About 60 sec later, confirm `suspended`, with `status_reason.code: website_review_failed` and the website due again.</li>
          <li>Stop payments, show the reason and ask for what is listed.</li>
          <li>Send `https://curlec.com`. Confirm the product is `activated` again.</li>
          <li>Webhooks received: `account.requirements.updated` (as the website check settles), `account.product.activated`, `account.product.suspended`. After the website, `account.requirements.updated` and `account.product.activated`.</li>
          <li>Status changes: `activated` → `suspended` → `activated`.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>35</td>
      <td>A link expires before the sub-merchant finishes it (also on every business type) Coming soon</td>
      <td>The hosted page's **Expire the link**</td>

      <td>
        <ol>
          <li>Run any link action (video KYC, DigiLocker or ₹1 UPI) and open its `url`.</li>
          <li>Pick **Expire the link**.</li>
          <li>Fetch the account. Confirm the action is still due.</li>
          <li>Show a fresh **Start again** that runs the action again for a new link. Never reuse an expired `url`.</li>
          <li>Webhooks received: none, because the requirements do not change.</li>
          <li>Status changes: none.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>36</td>
      <td>DigiLocker for the proof of address Coming soon</td>
      <td>The hosted page's **Share Aadhaar**, then **Decline**</td>

      <td>
        <ol>
          <li>With `proof_of_address_for_individual` due, run `create_aadhaar_digilocker_link` with your `return_url`. Open the `url` in its response.</li>
          <li>Pick **Share Aadhaar**. Confirm `proof_of_address_for_individual` clears and the page returns to your `return_url`.</li>
          <li>On another account, pick **Decline**. Confirm `proof_of_address_for_individual` stays due, with the action and the document uploads.</li>
          <li>Run the action again, or upload a document.</li>
          <li>Webhooks received: `account.requirements.updated` when the Aadhaar is shared. None after **Decline**.</li>
          <li>Status changes: none.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>37</td>
      <td>₹1 UPI check of the bank account (also on every business type) Coming soon</td>
      <td>The hosted page's **Pay ₹1**, then **Pay from another person's account**</td>

      <td>
        <ol>
          <li>With `bank_account` due after a failed bank check, run `create_upi_link`. Open the `url` in its response.</li>
          <li>Pick **Pay ₹1**. Confirm `bank_account` clears and the account is `verified`.</li>
          <li>On another account, pick **Pay from another person's account**. Confirm `bank_account` stays due.</li>
          <li>Run the action again, or send the account.</li>
          <li>Webhooks received: `account.requirements.updated` when the payment verifies the account. None after a failed payment.</li>
          <li>Status changes: none.</li>
        </ol>
      </td>
    </tr>

    <tr>
      <td>38</td>
      <td>Access withdrawn (also on every business type) Coming soon</td>
      <td>Settlement account `000000000007`</td>

      <td>
        <ol>
          <li>Run scenario 1 with this settlement account.</li>
          <li>About 60 sec after activation, confirm `account.consent.withdrawn` arrives.</li>
          <li>Stop calling the API for the account. Confirm later calls return `403 consent_withdrawn`.</li>
          <li>Webhooks received: `account.requirements.updated` (as the website check settles), `account.product.activated`, `account.consent.withdrawn`.</li>
          <li>Status changes: none after `activated`.</li>
        </ol>
      </td>
    </tr>
  </tbody>
</table>

## 4. Common Integration Gaps

These mistakes most often stall an onboarding or leave an account in the wrong state after go-live. **Test with** points to the scenario that proves you handled each one.

**Requirements and Values**

The table below lists gaps in handling requirements and values:

| Gap | What goes wrong in production | What to do | Test with |
| - | - | - | - |
| Mixing test businesses | The bank name match fails. It looks like a bug. | Use one test business per account. | Scenario 1 |
| A fixed form per business type | A requirement added after a failed check or review never reaches the sub-merchant. | Render `requirements` as returned, after every response. | Scenario 2 |
| Alternatives shown as separate questions | The sub-merchant pays ₹1 and also re-enters the account, or gives up. | Show the sub-requirements of a `one_of` composite as one choice. | Scenario 21 |

**Status and Webhooks**

The table below lists gaps in handling status and webhooks:

| Gap | What goes wrong in production | What to do | Test with |
| - | - | - | - |
| No path for video KYC | Sub-merchants without a CKYC record never activate. | Show the link when `create_video_kyc_link` is due, and keep it one tap away until it clears. | Scenario 3 |
| Treating `under_review` as final | You tell the sub-merchant they are live, or stuck, before the outcome arrives. | Act on the product `status` from the webhook or a fetch. | Scenario 33 |

**Error Handling and Messaging**

The table below lists gaps in error handling and messaging:

| Gap | What goes wrong in production | What to do | Test with |
| - | - | - | - |
| A failed check treated as an error | You discard a `200`, and the sub-merchant sees a generic failure. | Treat a failed check as data. Branch on the element's `verification.error_code` and show the requirement's `description`. | Scenario 21 |
| Matching on description text | A wording change breaks your handling. | Branch on `verification.error_code` and `error.reason`. | Scenario 23 |

## 5. Best Integration Practices

These practices apply to every onboarding integration. **On this page** says what each one means here. **Test it** points to the scenario that tests it.

The table below lists the best integration practices:

| Topic | What to know | On this page | Test it | Read more |
| - | - | - | - | - |
| Requirements per business type | The business type decides every other requirement, and it locks once the PAN verifies. | Send `business_type: individual` and the owner's PAN. An individual sends no business name or Goods and Services Tax Identification Number (GSTIN). | Scenario 1 | [Fetch an Account](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/fetch-account.md) |
| Actions, then values | A requirement with `requirement_type: action` names an action to run. Its response lists what is due next, such as a code to send or a link the sub-merchant completes. | The CKYC code, video KYC and the ₹1 UPI link all come as actions. | Scenario 1 | [Actions](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/actions.md) |
| Composite requirements | A `composite` requirement answers one point with its `sub_requirements`, combined as its `fulfillment_criteria` says. Under `one_of`, any one clears it. Under `any_of`, at least one clears it. Under `all_of`, you need every one. Its `requirement_code` is a documented point, such as `bank_account`. | PAN, CKYC, bank and proof of address are `one_of`. The terms, the bank account details, an address and a 2-sided document are `all_of`. A proprietorship's proof of business is `all_of` a document and a number. | Scenario 21 | [Requirement Entity](https://razorpay.com/docs/api/partners/accounts/requirement-entity.md) |
| Fetch as a fallback | Webhooks can be late or out of order. Fetch the account before anything irreversible. | Poll with a timeout in tests. | Scenario 4 | [Webhooks](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/webhooks.md) |

### Related Information

* [Test Your Integration](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration)
* [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)
* [Error Index](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/error-index.md)
* [Create an Account](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/create-account.md)
* [Fetch an Account](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/fetch-account.md)
* [Terms and Submission](https://razorpay.com/docs/partners/aggregators/onboarding-api/test-integration/terms-and-submission.md)
