brianhenryie/bh-wp-order-email-reconcile

Mark orders as paid by reconciling payment-confirmation emails. WooCommerce supported; designed to be extensible to other order sources (e.g. GiveWP).

dev-master 2026-08-22 07:47 UTC

Requires

• php: >=8.4
• ext-json: *
• brianhenryie/bh-wp-mailboxes: dev-master
• psr/log: *

Requires (Dev)

• ext-dom: *
• 10up/wp_mock: *
• antecedent/patchwork: ^2.1
• brianhenryie/bh-wp-logger: >0.3.4
• brianhenryie/color-logger: *
• dealerdirect/phpcodesniffer-composer-installer: *
• johnpbloch/wordpress: *
• lucatume/wp-browser: *
• mockery/mockery: *
• php-stubs/woocommerce-stubs: *
• phpcompatibility/phpcompatibility-wp: *
• phpstan/extension-installer: *
• phpstan/phpstan-mockery: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpunit/phpcov: *
• rector/rector: ^2.4
• squizlabs/php_codesniffer: *
• szepeviktor/phpstan-wordpress: *
• vlucas/phpdotenv: *
• wordpress/wordpress: *
• wp-coding-standards/wpcs: *
• wpackagist-plugin/give: ^4.15
• wpackagist-plugin/woocommerce: *
• wpackagist-plugin/wp-crontrol: ^1.21
• wpackagist-theme/storefront: *

GPL-2.0-or-later

• BrianHenryIE

Published on Packagist.org on 2026-08-24 00:31 UTC

README

BH WP Order Email Reconcile

Mark orders as paid by reconciling payment-confirmation emails against unpaid orders.

Emails are fetched and stored by BH WP Mailboxes. When new emails arrive, this library parses them and matches them to unpaid orders by order id (from the payment note), customer payment id (e.g. Venmo/$CashTag), email address, then name.

The core is integration-agnostic: it deals only with Unpaid_Order objects supplied by an Unpaid_Orders_Provider_Interface. WooCommerce is supported today; GiveWP is scaffolded as a second integration. See ARCHITECTURE.md and PLAN.md.

Usage

$settings = new My_Reconcile_Settings(); // implements Email_Reconcile_Settings_Interface
$logger   = Logger::instance( $settings );
BH_WP_Order_Email_Reconcile::make( $settings, $logger );

Call make() when your plugin file loads. It only registers hooks: the integrations (WooCommerce, GiveWP) are checked for availability at query time, so it does not matter whether those plugins have loaded yet. Do not defer instantiation past plugins_loaded — the cron jobs are (un)scheduled from plugins_loaded callbacks, which would then never run.

Email accounts (server, credentials, filters) are configured through the BH WP Mailboxes API; this library never stores credentials.

Development

See CONTRIBUTING.md.