> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchant Onboarding Status

> Check the merchant's onboarding status through API and webhooks.

<div style={{display:"flex",flexWrap:"wrap",alignItems:"center",gap:"0.35rem 0.9rem",border:"1px solid rgba(128,128,128,0.28)",borderRadius:"0.5rem",padding:"0.45rem 0.75rem",margin:"0 0 1.25rem",fontSize:"0.875rem"}}>
  <span style={{fontWeight:600}}>Available in</span>
  <span>🇮🇳 India</span>
</div>

You can retrieve a merchant's account onboarding status. Using this information, you can:

* Nudge your sub-merchants to complete their onboarding and get payments enabled.
* Know when the merchant account is activated to manage their payments.

There are two ways to fetch the status of merchant onboarding:

* [Using API](#using-apis)
* [Using Webhooks](#using-webhooks)

## Using API

Use the [Fetch account API](/docs/api/partners/account-onboarding/fetch) to get the onboarding status of the sub-merchant.

## Using Webhooks

[Subscribe to webhook events](/docs/partners/aggregators/onboarding-api/webhooks) to receive real-time notifications about the merchant account activation status.

| Webhook Event                   | Payload                                                                                       |
| ------------------------------- | --------------------------------------------------------------------------------------------- |
| `account.activated`             | [Sample Payload](/docs/webhooks/partners/activated#account-activated)                         |
| `account.under_review`          | [Sample Payload](/docs/webhooks/partners/under-review#account-under-review)                   |
| `account.needs_clarification`   | [Sample Payload](/docs/webhooks/partners/needs-clarification#account-needs-clarification)     |
| `account.suspended`             | [Sample Payload](/docs/webhooks/partners/suspended#account-suspended)                         |
| `account.rejected`              | [Sample Payload](/docs/webhooks/partners/rejected#account-rejected)                           |
| `account.activated_kyc_pending` | [Sample Payload](/docs/webhooks/partners/activated-kyc-pending#account-activated-kyc-pending) |
| `account.funds_hold`            | [Sample Payload](/docs/webhooks/partners/funds-onhold#account-funds-on-hold)                  |
| `account.funds_unhold`          | [Sample Payload](/docs/webhooks/partners/funds-unhold#account-funds-unhold)                   |
| `account.activated_kyc_pending` | [Sample Payload](/docs/webhooks/partners/activated-kyc-pending#account-activated-kyc-pending) |
| `account.instantly_activated`   | [Sample Payload](/docs/webhooks/partners/instantly-activated#account-instantly-activated)     |
| `account.payments_enabled`      | [Sample Payload](/docs/webhooks/partners/payment-enabled#account-payment-enabled)             |