Installation
Install WalletPro for WooCommerce on your store and complete initial configuration to enable the prepaid wallet system for your customers.
Requirements
Before installing WalletPro, confirm your environment meets the following minimum requirements.
| Component | Minimum Version | Recommended |
|---|---|---|
| PHP | 7.4 | 8.2+ |
| WordPress | 6.4 | Latest stable |
| WooCommerce | 8.2 | Latest stable |
| MySQL / MariaDB | 5.7 / 10.3 | 8.0+ / 10.6+ |
| WP Cron or server cron | Required for scheduled jobs | Server cron preferred |
WalletPro is fully compatible with WooCommerce High-Performance Order Storage (HPOS) and the WooCommerce Blocks checkout. No additional configuration is required to enable either feature.
Obtaining the Plugin
After purchasing WalletPro at walletpro.isupercoder.com, you will receive a download link and a license key by email. The downloadable file is a .zip archive named walletpro-for-woocommerce.zip.
Keep your license key accessible. You will enter it during the activation step after installation.
Installing the Plugin
Method 1: WordPress Admin Upload (Recommended)
- Log in to your WordPress admin dashboard.
- Navigate to Plugins > Add New Plugin.
- Click Upload Plugin at the top of the page.
- Click Choose File, select
walletpro-for-woocommerce.zip, and click Install Now. - After installation completes, click Activate Plugin.
Method 2: Manual FTP / SFTP Upload
- Extract
walletpro-for-woocommerce.zipon your local machine. This produces a folder namedwalletpro-for-woocommerce. - Connect to your server via FTP or SFTP.
- Upload the extracted folder to
/wp-content/plugins/. - In your WordPress admin, navigate to Plugins > Installed Plugins.
- Locate WalletPro for WooCommerce and click Activate.
Method 3: WP-CLI
# Upload the zip to your server first, then run:
wp plugin install /path/to/walletpro-for-woocommerce.zip --activate
Do not install WalletPro alongside other wallet or store credit plugins (e.g., WooCommerce Points and Rewards, YITH WooCommerce Wallet). Concurrent wallet plugins will conflict with checkout payment processing and the balance ledger. Deactivate any existing wallet plugins before activating WalletPro.
Activating Your License
WalletPro requires a valid license key to receive automatic updates and access support.
- After activation, navigate to WooCommerce > WalletPro > Settings.
- Select the License tab.
- Paste your license key into the License Key field.
- Click Activate License.
- The status indicator will update to Active once the key is verified against the licensing server.
If activation fails, check that your server can make outbound HTTPS requests to walletpro.isupercoder.com. Some hosts block outbound connections by default.
Database Setup
On first activation, WalletPro automatically creates the database tables it requires. This runs once and typically completes within a few seconds. You do not need to run any SQL manually.
The tables created include:
| Table | Purpose |
|---|---|
{prefix}_walletpro_ledger |
HMAC-chained audit ledger for all balance transactions |
{prefix}_walletpro_wallets |
Per-customer wallet records and currency balances |
{prefix}_walletpro_codes |
Redemption code inventory and usage tracking |
{prefix}_walletpro_transfers |
Wallet-to-wallet transfer records |
{prefix}_walletpro_withdrawals |
Customer withdrawal requests and status |
To verify the schema installed correctly, run the built-in diagnostic command via WP-CLI:
wp wallet doctor
This checks table integrity, HMAC chain continuity, and scheduled job registration. A passing run outputs All checks passed..
Initial Configuration
After activation, complete the following minimum configuration before going live.
1. Currency Settings
Navigate to WooCommerce > WalletPro > Settings > General.
- Wallet Currency Mode, Set to Store Default to use your WooCommerce currency, or Multi-Currency to issue wallets in the customer's active currency. Multi-currency requires a compatible currency switching plugin.
- Display Currency Symbol, Controls whether the wallet balance shown in My Account displays the currency symbol or the currency code.
2. Payment Method
Navigate to WooCommerce > Settings > Payments.
WalletPro registers a payment method called Wallet Balance. Enable it and set its display order relative to other payment methods. Customers will see this option at checkout when they have a non-zero balance.
3. Top-Up Product
WalletPro requires a WooCommerce product to act as the top-up vehicle so customers can add funds via any active payment gateway.
- Navigate to WooCommerce > WalletPro > Settings > Top-Up.
- Click Create Top-Up Product. WalletPro creates a simple virtual product and links it automatically.
- Optionally, configure Minimum Top-Up Amount and Maximum Top-Up Amount to constrain the amounts customers can add in a single transaction.
The top-up product is automatically excluded from coupon discounts, cashback rewards, and other wallet-funded promotions. You do not need to configure any exclusions manually.
4. My Account Integration
WalletPro adds a Wallet tab to the customer's WooCommerce My Account page automatically on activation. No page editing is required. To rename the tab label:
- Navigate to WooCommerce > WalletPro > Settings > General.
- Locate My Account Tab Label and change the value from the default Wallet to your preferred label.
- Click Save Changes.
Verifying the Installation
After completing initial configuration, perform the following checks.
- Navigate to WooCommerce > WalletPro > Overview. The dashboard should load without errors and display a zero-balance summary.
- Log in as a test customer and visit My Account > Wallet. The wallet dashboard should be visible with a zero balance.
- Add a small amount to the test customer's wallet by navigating to WooCommerce > WalletPro > Customers, selecting the customer, and using Manual Credit.
- Place a test order as the customer and confirm the Wallet Balance payment method appears at checkout and deducts the balance correctly on order completion.
- Run
wp wallet doctorand confirm all checks pass.
Updating WalletPro
With an active license, WalletPro updates appear in Plugins > Installed Plugins and Dashboard > Updates alongside your other plugins. Updates are applied through the standard WordPress update flow.
Before applying major version updates (e.g., 1.x to 2.x), review the changelog at walletpro.isupercoder.com/changelog for any breaking changes or required migration steps.
To update via WP-CLI:
wp plugin update walletpro-for-woocommerce
After any update, run wp wallet doctor to confirm schema and chain integrity.
Uninstalling
Deactivating and deleting the plugin through the WordPress admin does not remove WalletPro's database tables or stored data by default. This prevents accidental data loss.
To remove all plugin data permanently before deletion:
- Navigate to WooCommerce > WalletPro > Settings > Advanced.
- Enable Delete All Data on Uninstall.
- Click Save Changes.
- Deactivate and delete the plugin from Plugins > Installed Plugins.
Enabling Delete All Data on Uninstall will permanently remove all ledger entries, wallet balances, transfer records, and redemption codes when the plugin is deleted. This action cannot be undone. Export any data you need to retain before proceeding.