Admin Controls
Admin-side settings that change what customers see in Wallet Central. Most settings are shared with the wallet engine — Wallet Central reads the same options.
Master Toggle
Wallet → Settings → Wallet Central → Enable
| Option | Default |
|---|---|
_wkwp_central_enable | 1 (ON) |
OFF disables the entire /wallet-central/ surface:
- Rewrite rules removed
- CTA on legacy My Wallet hidden
- Bridge / settings AJAX skipped
- All
WKWP_Central_*classes still loaded but bootstraps skipped
Wallet engine continues to work — legacy /my-account/my_wallet/ and admin pages unaffected.
The Wallet Central toggles + every other section live on one Settings tab:
CTA Discovery
Wallet → Settings → Wallet Central → Discovery banner
| Option | Default |
|---|---|
_wkwp_central_cta_enable | 1 |
_wkwp_central_cta_dismissable | 1 |
_wkwp_central_cta_eyebrow | New |
_wkwp_central_cta_title | Try the new Wallet Central |
_wkwp_central_cta_sub | Faster, mobile-friendly, with QR pay and full activity in one place. |
_wkwp_central_cta_button | Open Wallet Central |
_wkwp_central_cta_version | bump to invalidate per-user dismissals |
See CTA Discovery.
Hero Variants & Tweaks
Wallet → Settings → Wallet Central → UI defaults
| Option | Default | Effect |
|---|---|---|
_wkwp_central_default_hero_variant | B | initial variant for new customers |
_wkwp_central_default_density | cozy | initial density |
_wkwp_central_default_accent | #6f3fff | initial accent (matches plugin theme) |
_wkwp_central_tweaks_enable | 1 | show / hide the gear panel |
See Tweaks & Responsive.
Recharge Presets
Wallet → Settings → Recharge → Preset chips
| Option | Default |
|---|---|
_wkwp_recharge_presets | 100,500,1000,2500,5000,10000 |
_wkwp_central_add_funds_chips_max | 6 (max chips rendered) |
Used by Wallet Central Add Funds + Home Quick Top-up. See Add Funds.
Withdrawal Settings
Wallet → Settings → Withdrawal
| Option | Effect on Wallet Central |
|---|---|
_wkwp_wallet_withdrawal_enable | hides withdraw view + disables tile |
_wkwp_wallet_withdrawal_methods[] | which radio cards render |
wallet_settings.min_amount / max_amount | UI input boundaries + summary |
wallet_settings.withdrawal_fee_type / _amount | fee row in summary |
_wkwp_wallet_withdrawal_hold_enable / _hold_days | "Will be paid by …" line |
_wkwp_central_withdraw_chips | quick chips on the form |
See Withdraw.
Transfer Settings
Wallet → Settings → Transfer
| Option | Effect |
|---|---|
_wkwp_wallet_transfer_enable | hides Send view + tile |
wallet_settings.min_transfer / max_transfer | UI boundaries |
wallet_settings.daily_max_transfer | progress bar in Limits card |
wallet_settings.transfer_fee_type / _amount | summary fee row |
_wkwp_central_recipient_lookup | autocomplete mode |
See Send Money.
KYC Gating
Wallet → Settings → KYC
| Option | Effect |
|---|---|
_wkwp_kyc_enable | global toggle |
_wkwp_wallet_kyc_required_features[] | which Wallet Central features show locked card |
_wkwp_kyc_max_documents | KYC view file cap |
_wkwp_kyc_max_size_mb | per-file cap |
_wkwp_kyc_allowed_mimes | allowed file types |
_wkwp_kyc_document_types[] | dropdown options on KYC view |
_wkwp_kyc_requirement_description | rich text above KYC form |
See KYC Flow.
QR Pay
Wallet → Settings → QR Pay
| Option | Effect |
|---|---|
_wkwp_wallet_qr_enable | hides QR view + tile |
_wkwp_wallet_qr_min_pay / _max_pay | scan-pay boundaries |
_wkwp_wallet_qr_otp_for_amounts_above | OTP threshold |
_wkwp_central_qr_default_mode | mine / scan initial mode |
_wkwp_central_qr_kyc_gate_mine | extra gate on receive (default OFF) |
_wkwp_qr_howitworks | array of 3 steps shown on QR view |
See QR Pay.
Referral
Wallet → Settings → Referral
| Option | Effect |
|---|---|
_wkwp_referral_enable | hides Refer & earn view |
_wkwp_referral_promo_enable / _start / _end / _multiplier | promo chip + countdown |
_wkwp_central_referral_share_buttons | which share buttons render |
_wkwp_central_referral_share_template | share text template |
_wkwp_central_referral_steps[] | how-it-works copy |
_wkwp_central_referral_invites_per_page | invites list page size |
See Refer & Earn.
Bonus
Wallet → Settings → Recharge → Bonus
| Option | Effect |
|---|---|
_wkwp_wallet_bonus_enable | bonus banner visibility on Add Funds |
_wkwp_wallet_bonus_amount | percent shown + applied |
Notifications
Wallet → Settings → Notifications
Wallet Central Settings view honours these admin defaults — they're the default state of customer-side toggles. Customer can override.
| Option | Default for customer toggle |
|---|---|
_wkwp_notify_credit_email_default | ON |
_wkwp_notify_debit_email_default | ON |
_wkwp_notify_low_balance_email_default | ON |
_wkwp_notify_transfer_received_sms_default | OFF |
_wkwp_notify_withdrawal_paid_sms_default | ON |
_wkwp_notify_kyc_email_default | ON |
See Settings, Email Notifications, SMS Notifications.
Auto-Reload
Wallet → Settings → Wallet Central → Auto-reload
| Option | Effect |
|---|---|
_wkwp_central_settings_auto_topup_enable | shows / hides Auto-reload section in customer Settings |
_wkwp_central_auto_topup_min_threshold | hard min the customer can set |
_wkwp_central_auto_topup_max_amount | hard max for top-up amount |
Daily Limits
Wallet → Settings → Limits
Shared with engine wallet_settings:
| Option | Effect |
|---|---|
wallet_settings.max_credit | top-up daily cap |
wallet_settings.max_amount | withdrawal daily cap |
wallet_settings.max_transfer | transfer daily cap |
Wallet Central Settings view shows these as progress bars — read-only to the customer.
Right-Rail Cards
Wallet → Settings → Wallet Central → Right rail
| Option | Default |
|---|---|
_wkwp_central_right_rail_pending_requests_enable | ON |
_wkwp_central_right_rail_saved_payees_enable | ON |
_wkwp_central_right_rail_linked_accounts_enable | ON |
_wkwp_central_right_rail_limits_enable | ON |
_wkwp_central_right_rail_refundable_enable | ON |
Toggle off any unwanted card.
Sub-View Rendering Order
Wallet → Settings → Wallet Central → Navigation order
_wkwp_central_nav_order[] — array of view slugs in the order they appear in the sidebar. Defaults to Router::VIEWS order.
Custom Help Strip
Wallet → Settings → Wallet Central → Help pills
| Option | Default |
|---|---|
_wkwp_central_help_pills[] | [ {label, url}, … ] |
Three pills shown at the bottom of every view. Default: FAQ / Support / Admin (admin only). Override with custom links — e.g. "Live chat" → your chat widget URL.
Bulk Suppress (admin)
Wallet → Settings → Notifications → Bulk operations
| Option | Effect |
|---|---|
_wkwp_bulk_suppress_emails | ON during bulk credit / debit runs |
Useful when running a 5000-row Q4 bonus — avoids spamming inboxes. Customer-side notifications resume after the batch.
Hooks
| Hook | Type | When |
|---|---|---|
wkwp_central_admin_settings_tabs | filter | append custom admin tab |
wkwp_central_admin_settings_render_<tab> | action | render custom tab |
wkwp_central_admin_settings_save_<tab> | action | persist custom tab |
Reset to Defaults
Each tab has a "Reset this tab" button (typed-confirm). For full reset:
WC → Status → Tools → Wallet → Reset Wallet Central UI defaults
Wipes only the _wkwp_central_* UI defaults — engine settings + customer balances untouched.
Tested Customer Pathways After Setting Changes
Whenever you flip a setting, test the customer-side reflection:
| Setting changed | Test |
|---|---|
_wkwp_central_enable OFF | /wallet-central/ → 404 |
_wkwp_wallet_withdrawal_enable OFF | Withdraw view → "disabled" message |
_wkwp_kyc_required_features[] adds transfer | Send view → locked card for non-approved |
_wkwp_referral_promo_enable ON with future end | Refer & earn view → promo chip with countdown |
_wkwp_wallet_bonus_amount = 25 | Add Funds → bonus banner reads 25% |