Payment Truth for WooCommerce
Read-only WooCommerce Stripe reconciliation for payment status, amount, currency, and refund mismatches.
View the Project on GitHub moxianyu6975-cpu/payment-truth-for-woocommerce
WooCommerce and Stripe Amount or Currency Mismatch
Quick answer
When the WooCommerce order total or currency differs from the matching Stripe payment, first confirm that the transaction reference is correct. Then compare values in the currency’s smallest unit and review manual edits, checkout customization, capture behavior, taxes, discounts, and timing. Do not assume that the customer was charged incorrectly from one displayed number alone.
Start with identifiers and units
An amount comparison is meaningful only when both records refer to the same transaction and currency. Check:
- WooCommerce order ID and Stripe PaymentIntent or charge ID.
- Live mode versus test mode and the correct Stripe account.
- ISO currency on both records.
- Gross WooCommerce order total versus Stripe’s authoritative authorized or collected amount.
- Currency decimals, especially zero-decimal and three-decimal currencies.
- Whether the order was edited after payment.
What a mismatch does and does not prove
The mismatch proves that the normalized stored values differ at scan time. It does not prove that Stripe processed the wrong amount, that WooCommerce calculated checkout incorrectly, or that either record should be edited. Those conclusions require order history, gateway logs, and checkout context.
Where Payment Truth helps
Payment Truth for WooCommerce normalizes the WooCommerce total into the currency’s smallest unit, using the official Stripe gateway helper when available. It compares that value and the ISO currency against the matching Stripe PaymentIntent or charge.
The plugin reports amount and currency disagreements as critical findings. It never captures an adjustment, edits totals, changes currency, or modifies the order.
Investigation checklist
- Verify the exact Stripe object reference.
- Compare order notes with Stripe timestamps.
- Review coupons, taxes, fees, shipping, manual edits, and custom checkout code.
- Check whether an authorization and later capture used the expected amount.
- Preserve evidence before correcting either system.