KYB / Production
Submit business verification so your organization can move from sandbox to production.
KYB (Know Your Business) is the business-verification step between a sandbox account and a production account. You'll come here once per organization to submit company details, representatives, and supporting documents — and come back if the first submission is rejected or you need to monitor review status.
Where to find it
Sidebar → KYB / Production. Requires the kyb.read permission.
Users without access see a locked state pointing them at an admin.
The page renders one of three states based on whether you have a KYB case:
- No case — a landing page explaining KYB with a Start verification button.
- Wizard open — the multi-step form while you fill it out.
- Active case — a status view showing where your submission stands.
Start KYB
- On the landing page, review the list of what you unlock after approval (production instances, real-money transactions, production API keys, priority support).
- Click Start verification under the Nora Verify card.
- The page transitions into the KYB wizard with step 1 active.
Fill out company details
The wizard walks you through four steps with a progress indicator at the top:
- Company details — company name, trading name, tax ID (CNPJ in Brazil), country (defaults to BRA), company type, and incorporation date.
- Legal address — street, city, state, postal code, country.
- Legal representatives — one or more people with name, role, email, and ownership percentage. Add as many as apply.
- Documents — upload the files listed (articles of incorporation, tax registration, etc.).
Each step has Back and Next buttons; the last step has a Submit button. Your progress persists within the wizard session, but leaving the page mid-wizard loses it.
Submit case
- On the Documents step, verify every required upload is attached.
- Click Submit.
- The wizard closes and the page transitions to the status view. Your case is now queued for review.
Check status
The status view shows:
- Current status badge: Pending review, In review, Approved, or Rejected.
- Submission metadata (company name, tax ID, submitted date).
- A reference number for support conversations.
- For rejected cases, the rejection reason.
- For approved cases, a call-to-action to provision your first production instance.
You can leave this page open during review — it refreshes when the status changes.
Retry on rejection
If your case is rejected:
- Read the rejection reason in the status view.
- Click Retry. The wizard reopens pre-filled with your previous answers so you only have to fix what was flagged.
- Correct the offending fields and upload replacement documents.
- Click Submit on the documents step.
Gotchas
- Production-gated. You only need KYB to move into production. Sandbox works without any KYB case.
- One retry at a time. A rejected case lets you retry once with prefilled data. Further rejections require starting a fresh case.
- Submission is one-way. Once submitted, you can't edit fields until the case is rejected and you click Retry. If you spot a mistake while in review, contact support.
- Representative ownership must total 100%. The list of representatives should cover the company's full ownership — missing or duplicated percentages will trip review.
- Review can take multiple business days. Status updates are pushed as webhooks (if you've configured them) and reflected on this page. Check the Webhooks page to subscribe.
See also
- Error handling (integrators) — where
kyb_not_approvedblocks offramp intents until this page flips to Approved.