Merchant Onboarding Capability
A governed foundation for moving merchants from prospect to application, review, readiness, approval, controlled activation planning, and monitoring context. Merchant activation remains approval-gated and execution-blocked.
Capability Overview
visible
Route: /merchant-onboarding
Current status: visible. Controlled pilot readiness: structured review ready. Human-review posture: required for every activation decision.
Capability status
visibleFoundation ready
The merchant onboarding capability is available as a read-only operating foundation.
Controlled pilot readiness
readiness onlyReady for structured review
Pilot onboarding evidence can be reviewed before any approval or activation decision.
Human-review posture
human review requiredRequired
Business, compliance, operations, provider, and executive review remain required.
Execution boundary
blockedBlocked
No merchant activation, account mutation, provider execution, KYB/KYC execution, or payment execution is enabled.
Execution boundary
Merchant onboarding is visible and governed, but activation, provider onboarding, KYB/KYC, sanctions screening, payments, ledger, settlement, treasury, and merchant mutation remain blocked.
A governed path from prospect to post-activation monitoring.
Every lifecycle stage includes purpose, owner, status, required evidence, and an explicit execution boundary.
Lifecycle stage
Prospect
Identify a potential merchant and determine whether they should enter structured onboarding review.
Owner
Merchant Success
Required evidence
- Commercial fit notes
- Merchant contact readiness
- Pilot interest context
Execution boundary
No merchant account creation or outreach automation is triggered.
Lifecycle stage
Application Started
Represent the start of an application journey without collecting or submitting live data.
Owner
Merchant Success
Required evidence
- Application readiness checklist
- Business intake preparedness
- Support expectations
Execution boundary
No application submission, email/SMS sending, or merchant mutation occurs.
Lifecycle stage
Business Profile Review
Review business identity, operating model, public presence, contacts, and support posture.
Owner
Business Operations
Required evidence
- Business information readiness
- Legal entity readiness
- Website and support readiness
Execution boundary
No legal entity verification, account creation, or profile update is executed.
Lifecycle stage
KYB/KYC Readiness Review
Confirm that KYB/KYC evidence can be reviewed by humans before any external screening.
Owner
Compliance
Required evidence
- Ownership readiness
- Document evidence readiness
- Identity review readiness
Execution boundary
No KYB/KYC execution, external screening, or regulated decisioning occurs.
Lifecycle stage
Compliance Review
Review business model, restrictions, sanctions/AML readiness, and compliance ownership.
Owner
Compliance
Required evidence
- Business model review
- Restricted business review
- Compliance owner review
Execution boundary
No sanctions screening, AML decisioning, approval, rejection, or account restriction occurs.
Lifecycle stage
Provider Readiness Review
Map merchant onboarding posture against provider readiness, credentials, and approval blockers.
Owner
Provider Operations
Required evidence
- Stripe readiness
- Mobile money readiness
- Provider blocker status
Execution boundary
No provider onboarding execution, provider account creation, API calls, or credential exposure occurs.
Lifecycle stage
Operations Readiness Review
Confirm support, monitoring, incident, refund support, runbook, and escalation readiness.
Owner
Operations
Required evidence
- Support readiness
- Runbook readiness
- Settlement observation readiness
Execution boundary
No ticket creation, workflow mutation, notification delivery, or settlement execution occurs.
Lifecycle stage
Executive Approval
Confirm leadership review before a merchant can move toward any controlled activation plan.
Owner
Executive Operations
Required evidence
- Go/No-Go posture
- Required evidence package
- Remaining blocker list
Execution boundary
No approval execution, activation mutation, or status update occurs.
Lifecycle stage
Controlled Activation
Document the future controlled activation stage while keeping activation blocked in this sprint.
Owner
Executive Operations and Provider Operations
Required evidence
- Executive approval
- Provider readiness
- Operations readiness
Execution boundary
Merchant activation, provider execution, payment execution, and live account assignment remain disabled.
Lifecycle stage
Post-Activation Monitoring
Prepare future monitoring posture for support, incidents, settlement observation, refunds, and risk review.
Owner
Operations
Required evidence
- Monitoring readiness
- Incident response readiness
- Refund support readiness
Execution boundary
No monitoring integrations, settlement release, or support workflow mutation is triggered.
Application requirements are visible, but no merchant data is collected or submitted.
The capability tracks readiness categories for future review only.
Business information readiness
readiness onlyBusiness name, operating model, and primary contact can be reviewed.
No business profile submission or mutation occurs.
Legal entity readiness
human review requiredLegal entity evidence requirements are visible for review.
No entity verification or document processing occurs.
Ownership readiness
human review requiredOwnership evidence posture is tracked for human review.
No beneficial-owner verification or identity screening occurs.
Bank account readiness
watchBank account evidence posture is visible for future payout readiness.
No bank account creation, verification, or payout enablement occurs.
Contact readiness
readiness onlyMerchant contact, support owner, and escalation readiness are visible.
No onboarding email, SMS, or invitation is sent.
Website readiness
readiness onlyMerchant website and public business presence can be reviewed.
No external crawling or automated risk decisioning occurs.
Terms/privacy/support readiness
readiness onlyCustomer-facing support and policy readiness can be reviewed.
No policy publication, update, or legal attestation occurs.
Risk disclosure readiness
human review requiredRisk disclosure posture is visible for compliance and executive review.
No automated eligibility scoring or regulated decisioning occurs.
KYB, KYC, sanctions, AML, and business review stay human-reviewed.
No external screening, compliance decision, regulated decisioning, or automated approval is enabled.
KYB readiness
human review requiredKYB checklist and evidence posture are visible.
No KYB execution or external verification occurs.
KYC readiness
human review requiredKYC readiness is represented for future human-reviewed workflows.
No KYC execution or identity decisioning occurs.
Sanctions/AML readiness
blockedSanctions and AML readiness requirements are visible.
No screening provider, OFAC API, sanctions API, or AML execution is called.
Business model review
human review requiredBusiness model review remains a compliance-owned human review.
No automated business approval or rejection occurs.
Restricted business review
human review requiredRestricted business policy posture is visible for compliance review.
No account restriction or regulated enforcement action occurs.
Document evidence readiness
readiness onlyDocument metadata requirements are visible.
No document upload, storage, parsing, or raw PII handling occurs.
Compliance owner review
human review requiredCompliance owner review is required before activation planning.
No compliance decision or automated approval occurs.
Provider dependencies are visible without provider onboarding execution.
Stripe, mobile money, bank API, FX, card processor, approval, and blocker posture remain review-only.
Stripe readiness
readyStripe controlled pilot evidence is available for review.
No Stripe API call, account creation, or payment execution occurs.
Mobile money readiness
watchMTN, M-PESA, Orange Money, and future mobile money readiness remain visible.
No mobile money provider onboarding or execution occurs.
Bank API readiness
watchBank provider readiness is tracked for future settlement and treasury planning.
No bank API calls or bank account creation occurs.
FX readiness
watchFX provider readiness is visible for future cross-border capability review.
No FX quote execution or conversion occurs.
Card processor readiness
readyCard processing readiness is represented through existing Stripe evidence.
No card processing, PaymentIntent, Checkout Session, or charge creation occurs.
Provider approval status
human review requiredProvider approval status remains a human-reviewed operating dependency.
No provider approval, production flag change, or credential activation occurs.
Provider blocker status
watchProvider blockers are visible for sequencing discussions.
No blocker resolution, external API call, or provider mutation occurs.
Support, incident, monitoring, runbook, escalation, refund support, and settlement observation posture.
Operations readiness is visible for pilot preparation without ticket creation, workflow mutation, settlement execution, or treasury movement.
Support readiness
readySupport route and customer-safe guidance are available.
No support ticket creation or outbound communication occurs.
Incident readiness
readyIncident response posture is documented through operations readiness.
No incident creation, paging, or alert dispatch occurs.
Monitoring readiness
readyMonitoring and observability readiness are available for review.
No monitoring integration mutation or live alert routing occurs.
Runbook readiness
readyRunbook readiness supports controlled pilot preparation.
No automated runbook execution occurs.
Escalation readiness
readiness onlyEscalation paths can be reviewed before controlled pilot use.
No escalation ticket or notification is generated.
Refund support readiness
readyInternal pilot refund validation is documented for support preparation.
No refund execution or provider action occurs.
Settlement observation readiness
watchSettlement observation posture remains visible for finance review.
No settlement release, balance mutation, or treasury movement occurs.
No merchant can move toward controlled activation without human approval.
The gate displays decision ownership, evidence requirements, go/no-go posture, current recommendation, and blockers. It does not approve, reject, activate, or mutate merchant state.
Approval required
true
Decision owner
Executive Operations with Compliance and Provider Operations input
Go/No-Go posture
GO WITH CONDITIONS for structured review only
Current recommendation
Proceed with Merchant #1 onboarding review preparation, but do not activate a merchant until evidence, compliance, provider, operations, and executive approvals are complete.
Required evidence
- Business profile readiness
- KYB/KYC readiness posture
- Compliance owner review
- Provider readiness and blocker review
- Operations readiness and support coverage
- Executive go/no-go approval
Remaining blockers
- Merchant #1 evidence package pending
- Compliance review not approved
- Provider activation not authorized for merchant assignment
- Controlled activation remains blocked
Advisory guidance for structured merchant review.
AI guidance is static, demo-safe, explainable, human-reviewed, and non-executing until a governed backend advisor is approved.
Merchant AI Onboarding Advisor
AI must not approve merchants, reject merchants, perform KYB/KYC, trigger screening, submit provider onboarding, mutate merchant state, or make regulated decisions.
Guidance
Merchant onboarding is ready for structured review.
Business profile readiness is visible.
KYB/KYC readiness remains human-reviewed.
Provider onboarding remains blocked until executive approval.
Operations readiness is sufficient for controlled pilot preparation.
Backend gap: No backend merchant onboarding AI endpoint is required for this foundation sprint; static demo-safe advisory content is used until a governed backend advisor is approved.
Read-only institutional timeline for onboarding capability context.
The timeline provides operating memory. It does not create tickets, mutate workflows, or trigger notifications.
Phase V
Merchant onboarding capability created
The first enterprise business capability establishes a read-only merchant onboarding lifecycle.
Phase IV
Merchant Success Platform established
Merchant revenue, payment, refund, settlement observation, support, and growth visibility are available.
Phase IV
Customer Experience Platform established
Customer trust, purchase, receipt, refund, subscription, and support guidance are available.
Phase IV
Ecosystem hub established
The unified ecosystem hub connects executive, merchant, customer, AI, provider, treasury, operations, and security surfaces.
Internal pilot
Stripe controlled pilot validated
Controlled Stripe payment evidence is available for review, without enabling this onboarding surface to execute payments.
Internal pilot
Refund validation completed
Refund evidence informs support readiness while this page performs no refund execution.
Phase III
Executive PMO established
PMO governance provides milestone, dependency, and executive operating context.
Next
Merchant #1 onboarding review pending
The first external merchant review remains pending and must stay human-reviewed.
Merchant onboarding connects into existing enterprise surfaces.
These links are navigation only and do not initiate workflows, submit data, call providers, or mutate merchant state.
Review activation readiness
human review requiredReview activation preconditions, readiness gates, executive approval posture, AI advisory guidance, stop conditions, and safety boundaries.
OpenReview activation control
human review requiredReview executive controlled merchant activation posture without activating merchants.
OpenOpen Executive Operations
readyReview executive readiness, risk, provider, and commercial posture.
OpenReview Compliance Operations
human review requiredReview compliance, KYB/KYC, AML, sanctions, restricted business, and evidence posture without triggering screening or decisions.
OpenMerchant onboarding remains visible, governed, and non-executing.
This foundation connects onboarding context across merchant success, executive operations, AI intelligence, compliance, provider readiness, operations, security, governance, and PMO without creating activation authority.
Merchant activation
false
Provider onboarding execution
false
KYB execution
false
KYC execution
false
Sanctions screening execution
false
Payment execution
false
Ledger execution
false
Settlement execution
false
Treasury movement
false
Merchant mutation
false
Autonomous AI decisioning
false
Secrets exposed
false
Credentials exposed
false
