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

# 7. Track Product Status

> Track a sub-merchant product's status using Razorpay Onboarding APIs.

Available in
🇮🇳 India

Fetching the account is always the source of truth. To avoid polling, subscribe to [webhooks](https://razorpay.com/docs/webhooks/partners/onboarding-apis.md).

## 7.1 Fetch the Account

[Fetch the account](https://razorpay.com/docs/api/partners/accounts/fetch.md) to see where it stands. The response shows:

* The `business_profile`, with its `stakeholders`, and the `bank_accounts` submitted so far, each with its verification
* Each product in `products`, with its `status` and `requirements`

The response leaves out addresses filled from a registry and the bank's name for the account holder. Know more about [data protection](https://razorpay.com/docs/partners/aggregators/onboarding-api#protect-sub-merchant-data).

`GET /v1/accounts/{account_id}`

```bash Curl theme={null}
curl -X GET https://api.razorpay.com/v1/accounts/acc_TcdGEzmfKQzEl1 \
-u rzp_test_partner_[CLIENT_ID]:[CLIENT_SECRET]
```

```json Response theme={null}
{
  "id": "acc_TcdGEzmfKQzEl1",
  "country": "IN",
  "statement_descriptor": {
    "value": "Acme Corp",
    "verification": {
      "status": "verified",
      "verified_at": 1792433135
    }
  },
  "is_mfa_enabled": false,
  "user": {
    "role": "owner",
    "email": "gaurav.kumar@example.com",
    "phone": "+919611752201",
    "name": "Gaurav Kumar",
    "is_email_verified": true,
    "is_phone_verified": true
  },
  "business_profile": {
    "business_type": "individual",
    "business_name": "GAURAV KUMAR",
    "date_of_establishment": null,
    "identity_numbers": {},
    "documents": {},
    "business_category": null,
    "authorized_person": {
      "name": "GAURAV KUMAR",
      "identity_numbers": {
        "individual_pan": {
          "type": "individual_pan",
          "value": "ABCPD1234A",
          "verification": {
            "status": "verified",
            "error_code": null,
            "error_description": null,
            "verified_at": 1792433290,
            "metadata": {},
            "created_at": 1792433290
          },
          "metadata": {},
          "is_skipped": false,
          "created_at": 1792433280,
          "updated_at": 1792433290
        },
        "individual_ckyc": {
          "type": "individual_ckyc",
          "value": null,
          "verification": {
            "status": "verified",
            "error_code": null,
            "error_description": null,
            "verified_at": 1792433340,
            "metadata": {},
            "created_at": 1792433340
          },
          "metadata": {
            "ckyc_mobile": "+919845098450"
          },
          "is_skipped": false,
          "created_at": 1792433340,
          "updated_at": 1792433340
        }
      },
      "documents": {
        "aadhaar_front": {
          "id": "file_Hx7Ui2kQe9Zf3A",
          "type": "aadhaar_front",
          "url": "https://files.razorpay.com/documents/file_Hx7Ui2kQe9Zf3A",
          "metadata": {
            "source": "ckyc",
            "file_name": "aadhaar-front.jpg",
            "mime_type": "image/jpeg",
            "size_bytes": 187342
          },
          "verification": {
            "status": "verified",
            "error_code": null,
            "error_description": null,
            "verified_at": 1792433340,
            "metadata": {},
            "created_at": 1792433340
          },
          "created_at": 1792433340
        }
      },
      "address": null,
      "date_of_birth": null,
      "additional_data": {},
      "created_at": 1792433280,
      "updated_at": 1792433340
    },
    "stakeholders": {},
    "addresses": [],
    "metadata": {}
  },
  "bank_accounts": {
    "settlements_primary": {
      "type": "settlements_primary",
      "account_number": "001234567890",
      "routing_code": "ICIC0000009",
      "routing_code_type": "IFSC",
      "supporting_document": null,
      "verification": {
        "status": "verified",
        "error_code": null,
        "error_description": null,
        "verified_at": 1792435025,
        "metadata": {},
        "created_at": 1792435011
      }
    }
  },
  "products": {
    "payment_gateway": {
      "type": "payment_gateway",
      "status": "in_progress",
      "status_reason": null,
      "created_at": 1792433135,
      "updated_at": 1792435025,
      "requirements": [
        {
          "id": "req_7zAE2YmS5MDUhG",
          "requirement_code": "business_category",
          "requirement_level": "mandatory",
          "requirement_type": "input",
          "description": "Select your business category, and send its subcategory with it.",
          "field_path": "business_profile.business_category.category",
          "value_type": "enum",
          "options": [
            {
              "label": "Ecommerce",
              "value": "ecommerce"
            },
            {
              "label": "Food and beverage",
              "value": "food"
            }
          ],
          "status": "created"
        },
        {
          "id": "req_0HAQYzBrDRNnEM",
          "requirement_code": "accept_terms_of_service",
          "requirement_level": "mandatory",
          "requirement_type": "composite",
          "description": "Show the sub-merchant Razorpay's terms of service and record their acceptance.",
          "fulfillment_criteria": "all_of",
          "sub_requirements": [
            {
              "id": "req_CTW6xxsQmygIDU",
              "requirement_code": "acceptance_ip",
              "requirement_level": "mandatory",
              "requirement_type": "input",
              "description": "The IP address the terms were accepted from.",
              "field_path": "products.payment_gateway.terms_of_service_acceptance.ip",
              "value_type": "text",
              "status": "created"
            },
            {
              "id": "req_gXg6igx2STKrZA",
              "requirement_code": "acceptance_device_fingerprint_id",
              "requirement_level": "mandatory",
              "requirement_type": "input",
              "description": "The device fingerprint of the device the terms were accepted on.",
              "field_path": "products.payment_gateway.terms_of_service_acceptance.device_fingerprint_id",
              "value_type": "text",
              "status": "created"
            }
          ],
          "status": "created"
        }
      ],
      "terms_of_service_acceptance": null,
      "payment_channels": {
        "website": {
          "primary": "https://www.example.com",
          "additional": [],
          "verification": {
            "status": "verified",
            "error_code": null,
            "error_description": null,
            "verified_at": 1792433250,
            "metadata": {},
            "created_at": 1792433220
          }
        },
        "app_android": null,
        "app_ios": null
      },
      "clarification_responses": {}
    }
  },
  "notes": {
    "shop_id": "60291847"
  },
  "created_at": 1792433135,
  "updated_at": 1792435025
}
```

> [accordion] Path Parameters
>
> `account_id` *mandatory*
> : `string` The account ID, `acc_`-prefixed. For example, `acc_TcdGEzmfKQzEl1`.

Refer to the [Account Entity](https://razorpay.com/docs/api/partners/accounts/entity.md) for every response parameter.

## 7.2 Product Status

Onboarding status lives on each product of the account. Activation needs the business's KYC verified and the product's own checks passed. These include the subcategory, and the website when one is sent. Razorpay checks the website again every year.

An account takes payments once the product's `status` is `activated`. You cannot set a product's status through the API. Razorpay moves it as it reviews the product. Refer to [Product States](https://razorpay.com/docs/partners/aggregators/onboarding-api#product-states) for every status and what to do in each.

## 7.3 Rejection and Suspension Reasons

A `rejected` or `suspended` product carries `status_reason`: a stable `code` to branch on and a `description` to show the sub-merchant. It is `null` in every other status. The wording of `description` can change, so branch only on `code`.

The table below lists the reasons:

| Code | Status | When | What the Sub-Merchant Sees |
| - | - | - | - |
| `category_not_allowed` | `rejected` | What the business sells is on Razorpay's restricted list. | `We can't offer payments for what your business sells.` |
| `clarification_not_answered` | `rejected` | The sub-merchant did not answer a reviewer's clarification in time. | `We didn't get answers to the review's questions in time, so we couldn't approve this application. Start a new application to try again.` |
| `identity_not_verified` | `rejected` | Razorpay could not verify the owner or authorised person, for example after failed video KYC calls. | `We couldn't verify the identity details on this application.` |
| `risk_review_failed` | `rejected` or `suspended` | Razorpay's risk review turned the account down. The reason never says which check failed, because Razorpay does not disclose screening outcomes. | `We can't offer payments to this business after our review.` |
| `website_review_failed` | `suspended` | The yearly website check failed, and the sub-merchant did not resolve it. | `Your website didn't pass the yearly check. Fix what's listed to start taking payments again.` |

A rejected product accepts no further changes. To try again, the sub-merchant starts a new account. A suspended product lists what would resolve it in its `requirements`. Answer them like any other requirement.

## 7.4 Status Webhooks

Subscribe to webhooks on the Partner Dashboard, once per mode, with an https URL, a secret and the events to receive. A product event fires on every change to `under_review`, `edd_pending`, `needs_clarification`, `activated`, `rejected` or `suspended`. This includes a change your own call caused, such as submitting. `created` and `in_progress` have no event.

Know more about [webhooks and payloads](https://razorpay.com/docs/webhooks/partners/onboarding-apis.md).

## 7.5 Manage Payment Methods

Manage the sub-merchant's payment methods, instruments and settings, such as international cards, with the [Payment Method APIs](https://slashdocs.razorpay.com/app/d/doc_oe6rsftby5u6uww6).

## Next Step

[Account Management](https://razorpay.com/docs/partners/aggregators/onboarding-api/account-management.md)
