Wallet Central — Overview

Standalone full-screen wallet experience at /wallet-central/. Self-contained HTML document — no theme header, footer, or sidebar. Lives parallel to the legacy /my-account/my_wallet/ submodule and never edits it.

Module

Module folder: wkwc_wallet_central/ · introduced in WP Wallet System v3.9.5 · Loader class WKWP_Central_Loader.

Wallet Central — first-fold dashboard at /wallet-central/ (sidebar + greeting + KPIs visible at a glance)

The full dashboard, end to end:

Wallet Central home — full dashboard with persistent sidebar, hero card, action grid, recent activity, and right-rail cards

Why a Separate Surface?

Reason	Notes
Theme isolation	Most WC themes inject 60+ KB of header / footer chrome around the My Account view. Wallet Central renders its own minimal shell — wallet UI gets the full viewport
Speed	Sub-200ms first paint vs 800-1500ms for theme-bound MyAccount
Mobile-first	One-column collapse, OTP cells, action grid all designed for small viewports
App-like feel	Custom navigation, side rail, density toggle, accent picker — feels like a real wallet app, not a WordPress page
Decorator-safe	Decorator on `/my-account/my_wallet/` still works — Wallet Central is additive, not replacement

Surface Map

/wallet-central/                       → Home dashboard
/wallet-central/transactions/          → Full transaction list
/wallet-central/send/                  → Send money (transfer)
/wallet-central/withdraw/              → New withdrawal
/wallet-central/withdrawals/           → Withdrawal request list
/wallet-central/withdrawals/view/123/  → Single withdrawal detail
/wallet-central/add-to-wallet/         → Top-up flow
/wallet-central/requests/              → Incoming + sent payment requests
/wallet-central/qr/                    → QR pay (mine + scan modes)
/wallet-central/referral/              → Refer & earn
/wallet-central/settings/              → Customer settings
/wallet-central/kyc/                   → KYC verification

Auth

Anonymous visit → redirected to wp-login.php?redirect_to=/wallet-central/. Customer must be logged in. No capability beyond read is required — every WC customer can access.

CTA on Legacy My Wallet

Legacy /my-account/my_wallet/ keeps its decorator-based UI. A small .wcc-cta-shell banner injects above the legacy hero pointing to Wallet Central. See CTA Discovery.

For comparison, the legacy view side-by-side:

Legacy My Wallet — at /my-account/my_wallet/, decorator-based UI

What's Inside

Section	Page
Endpoint, rewrite rules, sub-views	Endpoint & Routing
CTA on legacy My Wallet	CTA Discovery
Home dashboard layout	Home Dashboard
Top-up flow	Add Funds
Withdrawal flow	Withdraw
Withdrawals list + detail	Withdrawals List
Send money (transfer)	Send Money
QR — mine + scan	QR Pay
Payment requests inbox / outbox	Payment Requests
Refer & earn	Refer & Earn
Transactions list	Transactions
Customer-side settings panel	Settings
KYC submission within Central	KYC Flow
Loader / router / partials / bridge	Architecture
Tweaks panel + responsive breakpoints	Tweaks & Responsive
Nonce + AJAX security model	Security
Admin settings affecting Central	Admin Controls

Master Toggle

Whole module gated by option:

_wkwp_central_enable = "1"  // ON (default)
_wkwp_central_enable = "0"  // OFF — entire module silent

Set under Wallet → Settings → Wallet Central → Enable Wallet Central. When OFF:

No rewrite rules registered
No CTA on legacy My Wallet
All WKWP_Central_* classes still loaded but bootstraps skipped

Compatibility With Legacy

Legacy surface	Wallet Central effect
`/my-account/my_wallet/` decorator	Untouched
`/my-account/wkwc_withdrawal/` form POST	Wallet Central → Withdraw form posts to same legacy handler with same nonce — no new handler
Transfer AJAX `wkwc_wallet_pay_amount`	Wallet Central → Send form posts to same AJAX action — no new handler
Recharge product `wkwc_wallet`	Wallet Central → Add Funds redirects to same WC checkout flow
KYC submit AJAX `wkwp_kyc_submit`	Wallet Central → KYC view uses same action

Means: Wallet Central is a UI layer over the existing wallet engine. All business logic, ledger writes, gating, emails, payouts — same as legacy.

When to Use Each Surface

Surface	Best for
Wallet Central `/wallet-central/`	Customer-first wallet experience, mobile-friendly, faster paint, app-like nav
Legacy `/my-account/my_wallet/` decorator	Sticking with the standard WC My Account chrome — same theme, same sidebar, breadcrumbs intact

Most stores ship both. Customer can switch via the CTA. Some stores hide the legacy surface entirely via the wkwp_my_wallet_decorator_skip filter and use Wallet Central exclusively.

Quick Test

# As an anon visitor
curl -I https://yourstore.com/wallet-central/
# → 302 redirect to wp-login.php

# As a customer (cookie auth)
curl -b cookies.txt https://yourstore.com/wallet-central/
# → 200, body contains class="wcc-body"