=== Digages Customer Wallet for WooCommerce ===
Contributors: digages, timleyi
Tags: wallet, woocommerce, store credit, customer wallet, wallet payment
Requires at least: 5.8
Tested up to: 7.1
Stable tag: 1.0.3
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a customer wallet to WooCommerce with top-ups, wallet checkout payments, balances, account numbers, transaction history, and email notifications.

== Description ==

**Digages Customer Wallet for WooCommerce** gives every customer a store wallet they can fund and use to pay for orders.

Customers can top up through the normal WooCommerce checkout, view their current balance and transaction history from My Account, and pay for eligible orders with wallet funds. Store administrators can review customer balances and wallet transactions from a dedicated dashboard.

The plugin uses WooCommerce orders for wallet top-ups, records every successful credit and debit, and assigns a unique wallet account number to each customer.

Unlock all premium controls with [Digages Customer Wallet Pro](https://digages.com/customer-wallet/).

= Key Features =

* **Customer Wallet Dashboard**: Give customers a dedicated Wallet page inside WooCommerce My Account.
* **Wallet Top-Ups**: Let customers choose an amount and complete the top-up through WooCommerce checkout.
* **Full Wallet Payments**: Allow customers with sufficient funds to pay for an entire order from their wallet.
* **Classic and Block Checkout Support**: Use wallet payments on both the WooCommerce checkout shortcode and Checkout Block.
* **Unique Account Numbers**: Automatically assign a wallet account number to every customer.
* **Transaction History**: Show wallet credits, debits, descriptions, dates, and related order information.
* **Admin Wallet Management**: Review customer balances and browse wallet transactions from WordPress admin.
* **Top-Up Limits**: Configure minimum and maximum wallet top-up amounts.
* **Email Notifications**: Notify customers and administrators when wallet credit is added.
* **Default Neutral Accent**: Use the built-in #222222 accent across the customer wallet, checkout elements, and wallet emails.
* **Built-in Help Center**: Open wallet settings, administration shortcuts, documentation, reviews, feature requests, bug reports, and support links from WordPress admin.
* **Serialized Balance Updates**: Process wallet credits and debits safely per customer to reduce conflicting balance changes.
* **Partial Wallet Payments**: Apply available wallet funds and pay the remaining order amount with another WooCommerce gateway.
* **Multiple Admin Emails**: Send wallet notifications to multiple comma-separated administrator addresses.
* **Points & Rewards**: Reward paid WooCommerce orders with configurable customer points and let customers redeem points for checkout discounts.
* **DP Labels**: Use DP / DP by default (for example, “2,000 DP”) or rename the singular and plural points labels from the admin settings.
* **Points Administration**: Manage balances, review a points audit log, configure earning/redemption conversion rates, limits, taxes, and storefront messages.
* **Advanced Points Controls [PRO]**: Partial points redemption, points expiry, product-level discount caps, signup/review rewards, and safe previous-order backfill.
* **User-to-User Transfers [PRO]**: Let customers transfer wallet funds to other registered users.
* **Recipient Lookup [PRO]**: Find transfer recipients by wallet account number or email address whenever transfers are enabled.
* **Credit Wallets [PRO]**: Send wallet credit to one user or multiple users in a single admin operation.
* **Edit Transactions [PRO]**: Edit wallet transactions and automatically recalculate the affected balance.
* **Custom Accent Color [PRO]**: Enter an exact hex color for the customer wallet, checkout elements, and wallet emails.

**What's Next?:**
---------------------
If you like this plugin, then consider checking out our other plugins:

* [Direct Payments for WooCommerce - Bank Transfer, Mobile Money, Crypto and Peer-to-Peer (P2P) Payments](https://wordpress.org/plugins/direct-payments-for-woocommerce/)

* [Direct Payments WP - Receive Payments with Forms](https://wordpress.org/plugins/direct-payments-wp/)

* [Direct Invoices - Invoicing & Payment Requests for WordPress](https://wordpress.org/plugins/digages-direct-invoices/)

* [Engraver for WooCommerce - Personalize and Customize WooCommerce Products](https://wordpress.org/plugins/digages-engraver/)

* [APL – Auto-Pickup Locations for WooCommerce](https://wordpress.org/plugins/auto-pickup-locations-for-woocommerce/)

* [Digages Role Manager - User Roles & Permissions](https://wordpress.org/plugins/digages-role-manager/)

* [SVG Editor: Upload & Change Colors](https://wordpress.org/plugins/svg-editor/)

* [Digages Website Monitor](https://wordpress.org/plugins/digages-website-monitor/)

* [Digages Restock Alert](https://wordpress.org/plugins/digages-restock-alert/)



== Installation ==

Using The WordPress Dashboard:
---------------------

* Go to **WordPress Admin > Plugins > Add New Plugin**.
* Search for **Digages Customer Wallet for WooCommerce**.
* Click **Install Now**, then click **Activate**.
* Make sure WooCommerce is installed and active.

Manual Installation:
---------------------

* Go to **WordPress Admin > Plugins > Add New Plugin > Upload Plugin**.
* Choose the `digages-customer-wallet.zip` file and click **Install Now**.
* Activate the plugin after installation.

Wallet Setup and Configuration:
---------------------

* Go to **Customer Wallets > Settings**.
* Set the minimum and maximum top-up amounts.
* Configure customer and administrator email notifications.
* Customers can now open **My Account > Wallet** to view or top up their wallet.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. WooCommerce must be installed and active because top-ups, checkout payments, orders, currencies, and customer account pages use WooCommerce.

= How do customers add money to their wallet? =

Customers open **My Account > Wallet**, enter a top-up amount, and complete payment through the normal WooCommerce checkout. The wallet is credited when the top-up order reaches a supported paid status.

= Can customers pay for an entire order with wallet funds? =

Yes. The free version includes full wallet payments when the customer's available balance covers the complete order total.

= Can customers combine wallet funds with another payment gateway? =

Yes. Partial wallet payment is available in both Free and Pro. It applies wallet funds to the order and lets the customer pay the remaining amount through another enabled WooCommerce gateway.

= Can customers transfer wallet funds to another user? =

User-to-user transfers are available in Pro. Pro can also look up recipients by wallet account number or email address.

= Can an administrator send promotional or loyalty credit? =

Yes, in Pro. Open **Customer Wallets > Credit Wallets** to credit one customer or multiple customers in one operation. Free users can preview the feature from the same menu.

= Can I change the wallet color to match my brand? =

The default accent is #222222. Pro users can enter an exact hex color under **Customer Wallets > Settings > General**. Accent colors apply to the customer wallet, checkout elements, and wallet emails; WordPress admin screens keep their own fixed colors.

= Are wallet transactions recorded? =

Yes. Successful wallet credits and debits are stored in the wallet transaction table and displayed to customers and administrators.

= What is the difference between the Free and Pro versions? =

The Free version includes wallet top-ups, full and partial wallet checkout payments, balances, account numbers, transaction history, administration tools, basic Points & Rewards earning/redemption, configurable DP labels, and comma-separated admin notification addresses. Pro adds user transfers with recipient lookup, single and bulk wallet credit, transaction editing with balance recalculation, custom accent colors, points expiry, product discount caps, signup/review point rewards, and previous-order point backfill.

= How can I upgrade to Pro? =

Purchase a license from the [Digages Customer Wallet website](https://digages.com/customer-wallet/), install the Pro plugin, and activate the license under **Customer Wallets > License**.

== Screenshots ==

1. Customer wallet balance, account number, top-up form, and transaction history.
2. Wallet payment option at WooCommerce checkout.
3. Customer wallet administration dashboard.
4. Wallet transactions list.
5. Wallet settings with Free and Pro feature controls.
6. Built-in Help Center with wallet shortcuts and support resources.

== Changelog ==

= 1.0.3 =
* Changed: Merged eligible wallet and points checkout discounts into one balanced checkbox row and moved earning notices to the top-left of cart and checkout.
* Changed: Made the My Account wallet layout full width, added 12-item history pagination, white balance-card text, and copy confirmation feedback.
* Added: Separate Settings, Points, Notification, and Messages tabs.
* Changed: Empty points messages are no longer rendered, and maximum points discount is now a Pro-only control.

= 1.0.2 =
* Changed: Redesigned the customer wallet page with a unified wallet and points balance summary, streamlined top-up card, and responsive transaction history.
* Added: All Types, Wallets, and Points history filters with combined chronological pagination.
* Fixed: Checkout Block parity for wallet partial discounts and Points & Rewards redemption, including live Store API total refreshes and safe order-side wallet/points debits.
* Changed: Checkout balance text is combined into one Wallet + Points summary, with the points cash value shown alongside the DP balance.
* Changed: Removed partial points redemption; redemption now uses the maximum eligible points for the order.
* Changed: Admin tables use the available screen width on larger displays, and the Wallet / Points submenu labels are shorter.
* Fixed: Conversion-rate fields now accept normal integer currency values such as 1000 as well as decimal values; points-side conversion units are integer-only and saved values no longer display unnecessary trailing zeroes.
* Fixed: Free-edition partial wallet checkbox now immediately refreshes checkout and applies the selected wallet discount.
* Fixed: Preserved the WordPress plugin-row metadata so the installed plugin version is displayed again.
* Added: Points management with custom styling; point audit entries are included in the unified All Transactions view and points settings are merged into the main Settings page.
* Added: Configurable earning/redemption rates, DP labels, discount limits, tax handling, storefront messages, checkout redemption, and order rewards.
* Added: Pro-only points expiry, product discount caps, signup/review rewards, and safe previous-order backfill controls.
* Safety: Points & Rewards is disabled by default after upgrading an existing store and does not alter wallet data.

= 1.0.1 =
* Improved: Minor update

= 1.0.0 =
* Added: WooCommerce Checkout Block support for full wallet payments.
* Added: JSON-powered Digages plugin catalogue in the Help Center.
* Added: Built-in Help Center for wallet administration, documentation, feedback, and support shortcuts.
* Initial release of Digages Customer Wallet.

== Upgrade Notice ==

= 1.0.0 =
Upgrade for wallet admin headers that stay visible while scrolling and align directly with the WordPress navigation menu.


== Credits ==

Built by [Digages](https://profiles.wordpress.org/digages/#content-plugins).
