FAQ

Quick answers. For longer walk-throughs, click into the linked pages.

Licensing & Pricing

Q. How much does the plugin cost? A. One-time licence — single-site and multi-site tiers. See the store page. No monthly fees.

Q. Does the licence include support? A. Yes — typically 6 or 12 months of support depending on tier, and lifetime updates regardless.

Q. Can I use the plugin on a staging + production site? A. Yes. Single-site licences cover one production site; staging + dev are exempt.

Q. Does the plugin require any third-party paid service? A. No — base wallet works with zero third-party services. Optional integrations (PayPal payouts, Stripe payouts, Twilio SMS) require accounts with those providers but the plugin doesn't charge for them.

Compatibility

Q. Does it work with HPOS (High-Performance Order Storage)? A. Yes. All wallet-order metadata is stored via WC's WC_Data_Store API.

Q. WPML? A. Yes — translatable strings under contexts wkwp-wallet-admin, wkwp-wallet-emails, wkwp-wallet-shortcodes.

Q. Multisite? A. Yes — per-blog tables. Balances do not bridge across blogs (intentional; each blog is an independent store).

Q. WooCommerce Subscriptions? A. Yes — renewals charge wallet first, fall through to stored card on shortfall. Enable the bridge in Integrations Settings.

Q. Dokan / WCFM? A. Yes — vendor commissions settle to the vendor's wallet automatically.

Q. Block Checkout (Cart & Checkout blocks)? A. Yes — wallet gateway exposed as a block-compatible payment method.

Q. WP Multi Currency / WOOCS / YITH? A. Yes — wallet keys balance per-currency in multi-currency mode.

Q. Do I need to deactivate other wallet / refund-to-credit plugins? A. Yes — run only one wallet plugin to avoid duplicate ledgers and gateway conflicts.

Setup

Q. How long does setup take? A. ~5 min for the basic flow (install → enable gateway → top up a customer → place an order). Add cashback / KYC / BNPL / payouts incrementally.

Q. Where is the recharge product? A. Auto-created on activation. Products → All Products → Recharge Your Wallet. If missing, WC → Status → Tools → Wallet → Recreate recharge product.

Q. Does the customer need a real PayPal account to receive PayPal payouts? A. Yes. PayPal Payouts API requires the recipient's email to be a PayPal account (or PayPal will hold the funds 30 days for them to claim).

Q. Stripe payout — what does the customer need? A. A Stripe Connected Account (acct_xxx). Auto-onboarding via Stripe Account Links is built in — see Stripe Payout.

Wallet Balance & Ledger

Q. Where is the balance stored? A. Per-user meta _wkwc_wallet_amount. Multi-currency mode adds _wkwc_wallet_amount_<currency>.

Q. How do I add money to a customer's wallet manually? A. Users → [user] → Wallet card → Credit field + amount + note → Update Wallet.

Q. Can I bulk-credit 1000 customers from CSV? A. Yes — Wallet → Bulk Credit / Debit → CSV mode. See Bulk Credit / Debit.

Q. Does the wallet support negative balance? A. Only via BNPL feature (separate opt-in). Otherwise debits below zero are rejected.

Q. Can I see the full transaction history? A. Wallet → Transactions (admin) or /my-account/my_wallet/ (customer). CSV export available.

Payment & Checkout

Q. Can the customer pay only part of an order with wallet? A. Yes — split payment. Wallet covers what it can, secondary gateway covers the rest. See Wallet Payment Gateway.

Q. The wallet gateway hides on zero balance — can I show it anyway? A. Yes. Toggle "Show on zero balance" ON in the gateway settings. Useful when you want customers to know the option exists even before topping up.

Q. Can I block wallet payment on specific products? A. Yes — Products → [edit product] → Inventory tab → Exclude wallet payment. See Checkout Restriction.

Q. Can I disable wallet on sale items? A. Yes. Toggle in Wallet → Settings → Checkout Restriction.

Q. Can I give a discount to customers who pay with wallet? A. Yes. Wallet → Settings → Checkout Discount — fixed or percent. See Checkout Discount.

Refunds

Q. Can I refund an order to wallet instead of card? A. Yes — when the order was paid with wallet, the refund credits back automatically. For non-wallet orders, the customer can submit a refund-to-wallet request from My Account, admin approves. See Refund to Wallet.

Q. Does the customer get an email when a refund is approved? A. Yes. Standard wallet credit email + dedicated Refund approved email.

Q. Does refund auto-reverse the cashback I gave? A. Yes — proportional reversal on partial / full refund.

Cashback

Q. Can I run multiple cashback rules at once? A. Yes — defined as a list. Engine picks the first matching rule (by priority). To stack, build a single rule per category with the combined %.

Q. Per-product cashback? A. Yes — set scope to product and target the SKU IDs.

Q. Per-category cashback? A. Yes — same UI, scope category.

Q. Time-boxed cashback campaign? A. Yes — start_date / end_date fields on each rule.

KYC

Q. Can I require KYC before withdrawals only? A. Yes. Wallet → Settings → KYC → Required features → tick withdrawal only. Other features remain open.

Q. How many KYC documents per user? A. 1-5. Configurable via _wkwp_kyc_max_documents.

Q. Where are KYC documents stored? A. wp-content/uploads/wallet-kyc/<user_id>/ with .htaccess deny-all. Served via authenticated AJAX proxy with capability check.

Q. GDPR — do KYC docs auto-delete on user deletion? A. Yes — hooks into WP's wp_privacy_personal_data_erasers and deletes both DB rows and files.

Referral Program

Q. Can I run a multi-level referral chain? A. Yes — separate Multilevel feature. 1-10 levels with per-level percent. See Multilevel Referral.

Q. When does the referrer get credited? A. On the invitee's first completed order — not on signup.

Q. Can I run a time-limited promo (2× rewards for a fortnight)? A. Yes — Promo Multiplier window in Wallet → Settings → Referral. Pure dates + multiplier.

BNPL

Q. Can I limit BNPL to certain customers? A. Yes — three modes: whitelist, role-based, all-KYC-approved. See Buy Now Pay Later.

Q. What happens if the customer never repays? A. Auto-deduct from any future credit (cashback, top-up, refund). Admin can write off manually. Interest accrues if configured.

Notifications

Q. Can I disable certain emails? A. Yes. Toggle each one in Wallet → Settings → Notifications.

Q. Do email subjects support placeholders? A. Yes — WC standard placeholders ({site_title}, {customer_first_name}) plus wallet-specific ({wallet_balance}, {transaction_amount}). See Email Notifications.

Q. SMS provider other than Twilio? A. No native bridge — implement the WKWP_SMS_Provider interface and register via wkwp_sms_provider filter.

Performance

Q. Will it slow down my checkout? A. No — wallet hooks add < 5ms to checkout-time validation. Per-user balance is cached.

Q. How many transactions can it handle? A. 100M+ rows tested with daily rollup table for analytics. Recommend Redis / Memcached object cache for large stores.

Q. Does it have a database indexer? A. Yes — composite indexes on (user_id, created_at) and (type, created_at). Background re-indexer runs on cron.

Developer

Q. Where's the REST API? A. /wp-json/wkwp-wallet/v1/*. Admin keys via Wallet → Settings → API Keys. See REST API.

Q. Is there a hooks reference? A. Yes — full list at Filters & Hooks.

Q. WP-CLI commands? A. None first-class shipped. The plugin's Wallet_Core is callable from any custom WP-CLI command you write.

Q. Can I override email templates? A. Yes — copy templates/emails/<email>.php to wp-content/themes/<your-theme>/wallet-system/emails/<email>.php. See Email Notifications.

Migration

Q. Migrating from TeraWallet? A. Direct migration tool not shipped. Standard path: export TeraWallet ledger as CSV → import via Bulk Credit / Debit.

Q. Migrating from store-credit gift card plugins? A. Same path — export gift card balances per email, bulk credit via Bulk Credit / Debit.

Q. Does it track user data? A. Only the data needed to operate the wallet — balance, transactions, KYC docs (when submitted). No external analytics tracking.

Q. Personal data export plugin compatible? A. Yes — wallet rows + KYC rows export via WP's standard wp_privacy_personal_data_exporters.

Q. Personal data eraser plugin compatible? A. Yes — auto-deletes wallet rows + KYC docs on user erasure request.

Support

Q. Where do I get help? A. https://webkul.uvdesk.com/ — open a ticket. Include WP / WC / PHP versions and the System Status report.

Q. Is there a demo site? A. Yes — https://wpdemo.webkul.com/woocommerce-wallet-system/.