Skip to content

docs: refresh sandbox verification suffix behavior - #912

Draft
jaymantri wants to merge 2 commits into
mainfrom
ajay/sandbox-testing-docs-suffix-refresh
Draft

docs: refresh sandbox verification suffix behavior#912
jaymantri wants to merge 2 commits into
mainfrom
ajay/sandbox-testing-docs-suffix-refresh

Conversation

@jaymantri

@jaymantri jaymantri commented Sep 8, 2026

Copy link
Copy Markdown

What changed

mintlify/snippets/kyc/kyb-sandbox-suffixes.mdx

  • Old: 003 and 001 have no auto-decision and behave the same. New: 001PENDING, 002REJECTED, 003UNVERIFIED, other → APPROVED. Same mapping as individuals.
  • Old: businesses never resolve at creation. New: with Skip verification paperwork on, the suffix resolves the business at creation. No packet or POST /verifications is needed.
  • Old: regulated platforms resolve from the suffix at the first submission. New: regulated platforms approve the business at creation. The switch does not apply.
  • New: switch-ON creation emits CUSTOMER.KYB_* only. It creates no verification and emits no VERIFICATION.* event.
  • New: before the first POST /verifications, a PATCH to registrationNumber re-derives the status while the business is not final. APPROVED and REJECTED are final.
  • New: 003 on POST /verifications returns RESOLVE_ERRORS with POOR_QUALITY_DOCUMENT. Change the suffix and resubmit.
  • Warning: "auto-approved at its first submission" → "approved at creation".

mintlify/snippets/sandbox-verification.mdx

  • New intro line: POST /verifications emits VERIFICATION.IN_PROGRESS, then one VERIFICATION.<STATUS> event. The matching CUSTOMER.KYC_* / CUSTOMER.KYB_* event fires when the status changes.
  • Individuals, old: regulated platforms resolve from the suffix at creation. New: regulated platforms approve at creation, suffix not read. Switch-ON creation emits CUSTOMER.KYC_* only, no VERIFICATION.* event. A PATCH to fullName before the first submission re-derives while not final.
  • Individuals: "where the suffix resolves at creation" → "with Skip verification paperwork on" (four places). The table and the fix-and-resubmit steps are unchanged.
  • Business direct-API paragraph, old: 001 and 003 both need a complete packet. New: with the switch off every suffix needs a complete packet; with the switch on, 003 resolves with no packet and 001 still needs one.
  • Beneficial owners: added the 003UNVERIFIED row. A 002 owner rejects the business. A 001 registration number sets every owner PENDING without reading owner suffixes. Use 003 to test owners with the switch on.

mintlify/snippets/kyc/kyc-unregulated.mdx

  • Warning, old: with the switch on the suffix "resolves before any packet validation". New: it approves the business at creation.

mintlify/changelog.mdx

  • New September 2026 section at the top for the #34451 change: switch-ON businesses resolve from the registration-number suffix at create, CUSTOMER.KYB_* only. The older September sentence about businesses resolving at first submission now notes it was changed later that month.

Why

Verified against

webdev origin/main:

  • sparkcore/sparkcore/umaaas/grid_switches/umaaas/sandbox_grid_switch.py
  • sparkcore/sparkcore/grid/api_handlers/sandbox_business_verification.py
  • sparkcore/sparkcore/grid/api_handlers/sandbox_individual_verification.py
  • sparkcore/sparkcore/grid/api_handlers/sandbox_verification_outcome.py
  • sparkcore/sparkcore/grid/api_handlers/create_verification.py
  • sparkcore/sparkcore/kyx/kyx_sandbox_manager.py
  • sparkcore/sparkcore/ent/schema/grid/observers/ent_grid_customer_verification_webhook_observer.py

mint broken-links reports no broken links in the edited files. The 28 reported links are pre-existing in other files.

Match the sandbox customer-verification behavior shipped in
lightsparkdev/webdev:

- #34311 Unregulated preset and the Skip verification paperwork switch
- #34343 Business 003 resolves UNVERIFIED
- #34357 Verification webhooks: IN_PROGRESS then one outcome event
- #34451 Switch ON: businesses resolve from the suffix at create

Co-authored-by: Cursor <cursoragent@cursor.com>
@mintlify

mintlify Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Grid 🟢 Ready View Preview Sep 8, 2026, 10:26 PM

@vercel

vercel Bot commented Sep 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

2 Skipped Deployments
Project Deployment Actions Updated
grid-flow-builder Ignored Ignored Preview Sep 8, 2026 10:27pm UTC
grid-wallet-demo Ignored Ignored Preview Sep 8, 2026 10:27pm UTC

Request Review

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant