Skip to main content
The TeraWallet settings are divided into multiple tabs, each controlling specific aspects of the wallet behavior. Navigate to TeraWallet > Settings to access these options.

​
General Settings

This tab controls the fundamental behavior of the wallet system.
  • Enable Partial Payment: When active, customers can use their wallet balance for a portion of the total order.
  • Is auto deduct for partial payment: Automatically applies the customer’s wallet balance as a discount if partial payment is enabled.
  • Tax treatment (new in 1.6.4): Choose Wallet pays goods only (default) or Wallet pays the whole order including tax. See Partial & Combined Payments.
  • Deduct wallet balance (new in 1.6.4): Deduct the wallet portion at order placement (default) or when payment completes.
  • Refund wallet on partial refunds (new in 1.6.4): Return a proportional share of the wallet payment when a partial WooCommerce refund is issued. On by default.
  • Enable Wallet Transfer: Allow users to transfer funds to other registered customers using their email address.
  • Minimum/Maximum Transfer Amount: Bound how much a customer can send in a single transfer.
  • Transfer Charge: Optionally set a fixed or percentage-based charge for each fund transfer.
  • Enable Wallet Topup: Allow customers to add funds manually via their account dashboard.
  • Minimum/Maximum Topup Amount: Restrict the amount a customer can add to their wallet in a single transaction.

​
Credit/Cashback Settings

Configure how rewards are credited to users’ wallets.
  • Cashback Rule: Choose the calculation scope:
    • Cart Wise: Cashback based on the total cart value.
    • Product Wise: Cashback based on specific product settings.
    • Product Category Wise: Cashback based on the product category rules.
  • Cashback Type: Select Percentage or Fixed Amount.
  • Cashback Amount: The default value for the reward.
  • Max Cashback Amount: Caps the total reward per order to a specific limit.
  • Min Cart Amount for Cashback: The minimum total an order must reach to qualify for any cashback.
  • Max Cashback Scope (new in 1.6.1): Apply the cap per order (default on new installs) or per item.
  • Refund Clawback (new in 1.6.1): Proportionally reverse cashback when an order is refunded (off by default), with an optional allow negative setting.
  • Exclude Role from Cashback: Select user roles (e.g., Administrator, Vendor) that should not receive rewards.
  • Process Cashback Status: Define which WooCommerce order statuses trigger the reward (e.g., Completed, Processing).
See Cashback Rules & Priority Logic for the full calculation model.

​
Transaction Descriptions

New in 1.6.3. A dedicated settings tab for customizing ledger entry text.
Set per-category description templates so ledger entries read the way you want. Templates support tokens — {order_id}, {amount}, {user_name}, {currency} and {original_details} — and replace the system-generated description on new transactions when configured.

​
Gateway Settings

TeraWallet acts as a WooCommerce gateway. Here, you can control its visibility and fees.
  • Title/Description: Customize what customers see at checkout.
  • Payment Method Visibility: Hide the wallet gateway if the balance is zero or if specific products are in the cart.
  • Gateway Charges: Apply extra fees when customers use certain gateways to top up their wallets.

​
Actions Settings

Incentivize user engagement by rewarding specific site actions:
  • New User Registration: Credit a specific amount to new users upon signing up. Since 1.6.2 this also covers users created via SSO/SAML, social login, the REST API and WP-CLI.
  • Daily Visit: Reward users for logging in once per day.
  • Product Review: Credit users for leaving verified reviews on your products.
  • Referrals: Reward customers for referring visitors and sign-ups. Activity is recorded in a dedicated referrals ledger with a customer history view and an admin Referral Report.
  • Sell Content: Let users sell digital content and receive the proceeds into their wallet.
When configuring rewards for actions like registrations or reviews, ensure you have set limits to prevent abuse (e.g., limit daily visit rewards to once per 24 hours).