Installation

Install WalletPro for WooCommerce on your store and complete initial configuration to enable the prepaid wallet system for your customers.

Getting Started HPOS Compatible Blocks Checkout PHP 7.4+ WC 8.2+

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)

  1. Log in to your WordPress admin dashboard.
  2. Navigate to Plugins > Add New Plugin.
  3. Click Upload Plugin at the top of the page.
  4. Click Choose File, select walletpro-for-woocommerce.zip, and click Install Now.
  5. After installation completes, click Activate Plugin.

Method 2: Manual FTP / SFTP Upload

  1. Extract walletpro-for-woocommerce.zip on your local machine. This produces a folder named walletpro-for-woocommerce.
  2. Connect to your server via FTP or SFTP.
  3. Upload the extracted folder to /wp-content/plugins/.
  4. In your WordPress admin, navigate to Plugins > Installed Plugins.
  5. 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.

  1. After activation, navigate to WooCommerce > WalletPro > Settings.
  2. Select the License tab.
  3. Paste your license key into the License Key field.
  4. Click Activate License.
  5. 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.

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.

  1. Navigate to WooCommerce > WalletPro > Settings > Top-Up.
  2. Click Create Top-Up Product. WalletPro creates a simple virtual product and links it automatically.
  3. 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:

  1. Navigate to WooCommerce > WalletPro > Settings > General.
  2. Locate My Account Tab Label and change the value from the default Wallet to your preferred label.
  3. Click Save Changes.

Verifying the Installation

After completing initial configuration, perform the following checks.

  1. Navigate to WooCommerce > WalletPro > Overview. The dashboard should load without errors and display a zero-balance summary.
  2. Log in as a test customer and visit My Account > Wallet. The wallet dashboard should be visible with a zero balance.
  3. Add a small amount to the test customer's wallet by navigating to WooCommerce > WalletPro > Customers, selecting the customer, and using Manual Credit.
  4. 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.
  5. Run wp wallet doctor and 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:

  1. Navigate to WooCommerce > WalletPro > Settings > Advanced.
  2. Enable Delete All Data on Uninstall.
  3. Click Save Changes.
  4. 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.