manifest / ecommerce / woocommerce-wallet-platform

Wallet Platform for WooCommerce

WooCommerce wallet and store credit plugin for WordPress with a ledger-first architecture. Supports customer balances, wallet checkout, funding, holds, refunds, reconciliation, REST API, WP-CLI, reports, privacy tools, WooCommerce Blocks, idempotent transactions, audit logs and financial controls.

by Shahin Ilderemi · github.com/ildrm/woocommerce-wallet-platform · website

★ 1stars

0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/ildrm/woocommerce-wallet-platform/archive/refs/heads/main.zip

Readme github.com/ildrm/woocommerce-wallet-platform ↗

Ledger-first closed-loop wallet and store credit. 0.1.0 development build: the complete requested commercial platform is not finished or production certified. See delivery status and release gates.

Implemented: integer money, balanced journals, provenance lots, holds/capture/release, refunds, limits, idempotency, locking, reconciliation, audited staff actions, customer wallet/history, private funding orders, full wallet checkout, Blocks/Store API, REST/CLI, reports, privacy export and post-commit event delivery. PayPal split checkout, durable recovery and proportional mixed refunds are implemented with local protocol/WooCommerce tests and remain disabled by default. Real provider/browser acceptance and automatic top-up remain outstanding.

Install only on an isolated backed-up single-site WordPress/WooCommerce evaluation store with 64-bit PHP 8.2+, mysqli/mysqlnd and InnoDB. Copy to wp-content/plugins/woocommerce-wallet or install the development ZIP from php tools/package.php. Activate WooCommerce then this plugin; review WooCommerce → Wallet settings and perform a purchase/refund/reconciliation. Merchant guide.

composer install
npm ci
composer test
composer test:phpunit
php tests/concurrency.php
composer lint
vendor/bin/phpstan analyse --debug --memory-limit=1G --no-progress
vendor/bin/phpcs
npm run check
npm run build

No runtime Composer dependencies are required. The standalone suite uses SQLite by default; production concurrency also needs real MySQL/MariaDB evidence. Set WALLET_TEST_DSN, WALLET_TEST_USER and WALLET_TEST_PASSWORD for a disposable database only. Real WordPress tests need a separate installed site and WALLET_WP_PATH. Testing guide.

Architecture · invariants · schema · ledger · checkout · API · extension API · PayPal · security · privacy · compatibility · operations · editions.

Deactivation and default uninstall preserve financial records. GPL-3.0-or-later; see LICENSE.