> For the complete documentation index, see [llms.txt](https://docs.lumia.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lumia.org/tokenize/kyc-for-issuers/on-chain-kyc-for-issuers.md).

# On chain KYC for issuers

**Who this is for:** issuers deciding how to gate their token by identity, from a decision-making rather than a code-level view. For the developer-side integration steps, see [Integrate on-chain KYC (dev guide)](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/build-on-lumia/identity/integrate-on-chain-kyc-dev-guide). For what KYC verifies as a concept, see [KYC (Know Your Customer)](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/ecosystem/lumia/compliance/kyc-know-your-customer).

### What an issuer decides

Before any integration work happens, an issuer using on-chain KYC needs to settle:

* **Who needs to pass.** Every holder, or only holders above a certain allocation size or tier: see [Eligibility & investor tiers](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/tokenize/eligibility-and-investor-tiers).
* **What "verified" means.** A binary pass/fail, or a level tied to jurisdiction, accreditation status, or another category your counsel has defined per [Compliance overview for issuers](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/tokenize/legal/compliance-overview-for-issuers).
* **What happens on failure or lapse.** Whether a transfer to an unverified address simply reverts, whether an already-verified holder can later fall out of compliance (a credential expiring, for example), and what that does to their existing balance.
* **Who provides verification.** Whether you integrate a third-party KYC provider yourself, or rely on a Lumia-documented verifier pattern.
* **Data retention.** What evidence of the check you keep off-chain, and for how long: a requirement your counsel sets, not this documentation.

### Where the technical integration lives

{% hint style="info" %}
The concrete verifier flow, contract-level pattern, and any code sample live at [Integrate on-chain KYC (dev guide)](https://app.gitbook.com/s/chmhPiVNAafGw48c4oU2/build-on-lumia/identity/integrate-on-chain-kyc-dev-guide). That page is written for a developer audience and is the single source for the integration mechanics. This page does not duplicate it.
{% endhint %}