Customer-facing KYC submission form (modal-based on my-wallet)
Multi-document upload (1-5 docs, configurable via _wkwp_kyc_max_documents)
Full-name + document-type + document-number + file
Nonce-protected submission (wkwp_kyc_submit)
MIME + size validation via wp_handle_upload
Admin review (approve / reject + admin note)
Status meta _wkwp_kyc_status (approved / pending / rejected)
Legacy fallback meta _kyc_verified
Customer-facing rules / instructions admin option (_wkwp_kyc_requirement_description)
Restricted features (_wkwp_wallet_kyc_required_features[]):
- withdrawal, transfer, wallet_usage (checkout), payment_request, qr_pay
Per-action gates (_wkwp_kyc_gate_*) — withdrawal / transfer / fund_request
Server-side enforcement (authoritative)
Greeting state pills — "✓ KYC VERIFIED" / "VERIFY KYC" / "KYC UNDER REVIEW" / "RE-SUBMIT KYC"
Modal-based submission with native <dialog>

12. Referral Program → details

Unique alphanumeric referral code per user (BOB22, AARAV42)
Backward-compatible ?ref= accepts numeric IDs and alpha codes
Cookie-based attribution (7-day default, HttpOnly + SameSite=Lax)
Referrer reward credited on invitee's first completed order
Referee first-order coupon WELCOME-XXXXXX — single-use, email-restricted
- Type fixed_cart or percent, configurable amount
- First-order-only via woocommerce_coupon_is_valid filter
Time-boxed promo multiplier (start / end / multiplier)
Registration form referral code field, prefilled from cookie
Unified dashboard on /my-account/my_wallet/
- Personal link pill + Copy button
- Brand-coloured share buttons (WhatsApp / X / Email / Messenger)
- Stats: total earned / invited / signed up / pending
Idempotency — one row per invitee + reward_amount > 0 lock
Admin gated end-to-end via _wkwp_referral_enable

13. QR Code Payments → details

Admin REST endpoints
- GET /wkwp-wallet/v1/analytics/summary
- GET /wkwp-wallet/v1/analytics/chart?days={int}
Summary KPIs — total credited / debited / active users / transactions
Chart — balance trends, transaction volume
Cached summary, invalidates on wallet update + withdrawal approval

POST /wkwc_wallet/v1/verify_otp/{otp} — OTP verify
GET /wkwp-wallet/v1/wallets / GET /wkwp-wallet/v1/wallets/{id} — admin
GET /wkwp-wallet/v1/transactions — admin
GET /wkwp-wallet/v1/analytics/summary — admin
GET /wkwp-wallet/v1/analytics/chart — admin
API key admin UI (mint / list / revoke / delete) with Basic Auth consumer key/secret

Self-managed storage layer for ledger, history, withdrawals, refund requests, cashback rules, BNPL debts, bulk-credit queue, KYC submissions + documents, referral log, and email invitations
Auto-created and migrated on activation; survives deactivation; never auto-dropped on uninstall

Admin-configurable % bonus on wallet top-up orders
Flags _wkwp_wallet_bonus_enable + _wkwp_wallet_bonus_amount
Credits bonus on woocommerce_order_status_completed for wkwc_wallet line items
Idempotency via _wkwp_bonus_credited order meta
Live preview on my-wallet Add-funds panel

Optional wkwp_multilevel_enable + wkwp_multilevel_levels (1-10) + wkwp_multilevel_level_commissions[]
Walks ancestry on invitee signup via WKWP_Referral_Signup_Enricher
Filter wkwp_referral_base_amount applies promo multiplier when active
Zero-config → flat single-level reward only

Reparents WC submodule template into modern fintech layout — zero template edits
Full-bleed profile greeting + Transactions stat + KYC pill
Credit-card hero (₹ balance, masked wallet ID WK-0000-••••-NNNN)
2×2 action grid (Add money / Send / Withdraw / Redeem code) → native <dialog> modals
Add-funds form with preset chips + custom amount + paychip + violet CTA
Inline top-up bonus banner under Pay-with row
Activity list with iconised rows + Recent-activity filter + pagination

Metric	Count
Major feature areas	32
Payment integrations	3 (Wallet gateway, PayPal, Stripe)
REST endpoints	5+
Custom DB tables	~11
Submodules	3 (`wkwc_wallet`, `wk_caching`, `wk-plugin-updates`)
Shortcodes	7+
KYC docs per user	1-5 (configurable)
Referral chain depth	1-10 levels