AnnuVera Holdings Inc. official logoAnnuVera
Merchant Lifecycle

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

visible

Foundation ready

The merchant onboarding capability is available as a read-only operating foundation.

Controlled pilot readiness

readiness only

Ready for structured review

Pilot onboarding evidence can be reviewed before any approval or activation decision.

Human-review posture

human review required

Required

Business, compliance, operations, provider, and executive review remain required.

Execution boundary

blocked

Blocked

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.

Merchant Lifecycle Model

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

visible

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

readiness only

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

human review required

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

human review required

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

human review required

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

watch

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

ready

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

human review required

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

blocked

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

readiness only

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.

Merchant Application Readiness

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 only

Business name, operating model, and primary contact can be reviewed.

No business profile submission or mutation occurs.

Legal entity readiness

human review required

Legal entity evidence requirements are visible for review.

No entity verification or document processing occurs.

Ownership readiness

human review required

Ownership evidence posture is tracked for human review.

No beneficial-owner verification or identity screening occurs.

Bank account readiness

watch

Bank account evidence posture is visible for future payout readiness.

No bank account creation, verification, or payout enablement occurs.

Contact readiness

readiness only

Merchant contact, support owner, and escalation readiness are visible.

No onboarding email, SMS, or invitation is sent.

Website readiness

readiness only

Merchant website and public business presence can be reviewed.

No external crawling or automated risk decisioning occurs.

Terms/privacy/support readiness

readiness only

Customer-facing support and policy readiness can be reviewed.

No policy publication, update, or legal attestation occurs.

Risk disclosure readiness

human review required

Risk disclosure posture is visible for compliance and executive review.

No automated eligibility scoring or regulated decisioning occurs.

Compliance Readiness

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 required

KYB checklist and evidence posture are visible.

No KYB execution or external verification occurs.

KYC readiness

human review required

KYC readiness is represented for future human-reviewed workflows.

No KYC execution or identity decisioning occurs.

Sanctions/AML readiness

blocked

Sanctions and AML readiness requirements are visible.

No screening provider, OFAC API, sanctions API, or AML execution is called.

Business model review

human review required

Business model review remains a compliance-owned human review.

No automated business approval or rejection occurs.

Restricted business review

human review required

Restricted business policy posture is visible for compliance review.

No account restriction or regulated enforcement action occurs.

Document evidence readiness

readiness only

Document metadata requirements are visible.

No document upload, storage, parsing, or raw PII handling occurs.

Compliance owner review

human review required

Compliance owner review is required before activation planning.

No compliance decision or automated approval occurs.

Provider Readiness

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

ready

Stripe controlled pilot evidence is available for review.

No Stripe API call, account creation, or payment execution occurs.

Mobile money readiness

watch

MTN, M-PESA, Orange Money, and future mobile money readiness remain visible.

No mobile money provider onboarding or execution occurs.

Bank API readiness

watch

Bank provider readiness is tracked for future settlement and treasury planning.

No bank API calls or bank account creation occurs.

FX readiness

watch

FX provider readiness is visible for future cross-border capability review.

No FX quote execution or conversion occurs.

Card processor readiness

ready

Card processing readiness is represented through existing Stripe evidence.

No card processing, PaymentIntent, Checkout Session, or charge creation occurs.

Provider approval status

human review required

Provider approval status remains a human-reviewed operating dependency.

No provider approval, production flag change, or credential activation occurs.

Provider blocker status

watch

Provider blockers are visible for sequencing discussions.

No blocker resolution, external API call, or provider mutation occurs.

Operations Readiness

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

ready

Support route and customer-safe guidance are available.

No support ticket creation or outbound communication occurs.

Incident readiness

ready

Incident response posture is documented through operations readiness.

No incident creation, paging, or alert dispatch occurs.

Monitoring readiness

ready

Monitoring and observability readiness are available for review.

No monitoring integration mutation or live alert routing occurs.

Runbook readiness

ready

Runbook readiness supports controlled pilot preparation.

No automated runbook execution occurs.

Escalation readiness

readiness only

Escalation paths can be reviewed before controlled pilot use.

No escalation ticket or notification is generated.

Refund support readiness

ready

Internal pilot refund validation is documented for support preparation.

No refund execution or provider action occurs.

Settlement observation readiness

watch

Settlement observation posture remains visible for finance review.

No settlement release, balance mutation, or treasury movement occurs.

Executive Approval Gate

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

human review required

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
Merchant AI Onboarding Advisor

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.

AdvisoryExplainableHuman ReviewedNo Autonomous Execution

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.

Onboarding Activity Timeline

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.

visible

Phase IV

Merchant Success Platform established

Merchant revenue, payment, refund, settlement observation, support, and growth visibility are available.

ready

Phase IV

Customer Experience Platform established

Customer trust, purchase, receipt, refund, subscription, and support guidance are available.

ready

Phase IV

Ecosystem hub established

The unified ecosystem hub connects executive, merchant, customer, AI, provider, treasury, operations, and security surfaces.

ready

Internal pilot

Stripe controlled pilot validated

Controlled Stripe payment evidence is available for review, without enabling this onboarding surface to execute payments.

ready

Internal pilot

Refund validation completed

Refund evidence informs support readiness while this page performs no refund execution.

ready

Phase III

Executive PMO established

PMO governance provides milestone, dependency, and executive operating context.

ready

Next

Merchant #1 onboarding review pending

The first external merchant review remains pending and must stay human-reviewed.

human review required
Cross-platform context

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.

Open ecosystem hub

ready

Review the unified cross-platform operating context.

Open

Open Merchant Success

ready

Review merchant health, revenue, support, and growth visibility.

Open

Review activation readiness

human review required

Review activation preconditions, readiness gates, executive approval posture, AI advisory guidance, stop conditions, and safety boundaries.

Open

Review activation control

human review required

Review executive controlled merchant activation posture without activating merchants.

Open

Review merchant operations

ready

Review post-onboarding operations readiness without execution.

Open

Open Executive Operations

ready

Review executive readiness, risk, provider, and commercial posture.

Open

Open merchant platform

ready

Review existing merchant platform shell and dashboards.

Open

Review Compliance Operations

human review required

Review compliance, KYB/KYC, AML, sanctions, restricted business, and evidence posture without triggering screening or decisions.

Open

Review provider platform

watch

Review provider readiness and blockers without provider execution.

Open

Review operations platform

ready

Review support, incident, runbook, and operations posture.

Open

Review trust center

ready

Review security, privacy, compliance, and reliability evidence.

Open
Safety Boundary

Merchant 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