=== 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.0
Stable tag: 1.0.0
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.
* **Custom Accent Color**: Match the customer wallet, checkout elements, admin wallet screens, and wallet emails to your brand in both Free and Pro.
* **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 [PRO]**: Apply available wallet funds and pay the remaining order amount with another WooCommerce gateway.
* **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.
* **Admin Bonus Credit [PRO]**: Send bonus credit to one user or multiple users in a single admin operation.
* **Transaction Editor [PRO]**: Edit wallet transactions and automatically recalculate the affected balance.
* **Multiple Admin Emails [PRO]**: Send wallet notifications to multiple administrator email addresses.

**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.
* Go to **Settings > Permalinks** and click **Save Changes** once to register the wallet endpoint.
* 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? =

Partial wallet payment is available in the Pro version. 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. Administrators can send bonus credit to one customer or select multiple customers and credit them in one operation.

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

Yes. Go to **Customer Wallets > Settings > General** and choose an Accent Color. The selected color is applied to the customer wallet, checkout elements, wallet admin screens, and wallet emails. This option is included in both Free and Pro.

= 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 wallet checkout payments, balances, account numbers, transaction history, administration tools, and standard email notifications. Pro adds partial payments, user transfers, recipient lookup, single and bulk admin bonus credit, transaction editing with balance recalculation, and multiple admin notification addresses.

= 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.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).
