Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/malsubrata/woo-wallet/archive/refs/heads/master.zipOn Packagist as malsubrata/woo-wallet:
composer require malsubrata/woo-walletNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
TeraWallet (formerly WooWallet)
TeraWallet is the leading wallet system for WooCommerce, providing a seamless digital currency experience for WordPress sites. It allows customers to store funds, earn rewards through various site activities, and use their balance for fast, secure checkouts.
📚 Documentation
- Admin Guide: Configuration, rewards, and technical architecture.
- Customer Guide: Usage instructions and FAQs for shoppers.
🚀 Key Features
- Digital Ledger: Secure transaction history for every user.
- Flexible Top-ups: Customers can add funds via any WooCommerce gateway.
- Partial Payments: Use wallet balance combined with other payment methods.
- Cashback Engine: Rewards based on Cart, Product, or Category rules.
- Incentivized Actions: Earn balance for Signups, Reviews, Referrals, and Daily Visits.
- Peer-to-Peer Transfers: Users can send balance to other registered customers.
- Marketplace Ready: Full compatibility with Dokan, WCFM, and WCMarketplace.
🛠 Developer Section
Core Logic & Hooks
The system uses a strict database-first approach with MySQL-level locking to ensure transaction integrity.
- Filters:
woo_wallet_current_balance: Modify balance display.woo_wallet_payment_is_available: Programmatically toggle the wallet gateway.woo_wallet_cashback_amount: Adjust calculated rewards.
- Actions:
woo_wallet_transaction_recorded: Fires after any ledger update.woo_wallet_payment_processed: Fires after a successful wallet purchase.woo_wallet_admin_adjust_balance: Fires when admins manually edit balance.
REST API (v3)
TeraWallet extends the WooCommerce REST API under the wc/v3/wallet namespace.
GET /balance?email={email}: Retrieve user balance.GET /?email={email}: Retrieve transaction list.POST /: Create credit/debit transactions (Admin only).
📂 File Structure
includes/class-woo-wallet-wallet.php: Core ledger and balance logic.includes/class-woo-wallet-frontend.php: Shortcodes and checkout integration.includes/actions/: Logic for earning balance via site activities.templates/: UI components (Overridable via theme).
📄 License
This project is licensed under the terms found in the LICENSE file.