WooCommerce 10.9.4 includes a block checkout fix related to VAT-exempt customers. Stores that use tax exemptions should test more than checkout success. The order record, refund calculation, customer email, and accounting export must show the same tax and net totals.
Use this for WooCommerce stores with VAT exemptions, tax-exempt customers, wholesale roles, custom tax plugins, refunds, or email template overrides.
Quick answer
WooCommerce 10.9.4 Tax Exempt Refund Email Cross Check should be handled with a narrow evidence-first workflow: build test order, capture totals, test refunds, then verify the result before making broader changes.
What to check first
- Create a staging customer with the same tax-exempt rules, address, role, and cart conditions used in production.
- Record subtotal, discount, shipping, tax, and total at checkout and on the saved order.
- Issue a partial and full refund, then compare refunded tax and item values.
- Compare customer and admin email values against the order and refund records.
- Review transactional email logs and accounting exports for stale or recomputed totals.
Diagnostic table
Use this table to keep the work practical. It connects the symptom to evidence and a verification step.
| Action | Evidence to collect | How to verify |
|---|
| Build test order | Create a staging customer with the same tax-exempt rules, address, role, and cart conditions used in production. | Checkout and saved order totals match for the tax-exempt customer. |
| Capture totals | Record subtotal, discount, shipping, tax, and total at checkout and on the saved order. | Partial and full refunds preserve the intended tax treatment. |
| Test refunds | Issue a partial and full refund, then compare refunded tax and item values. | Customer and admin emails display saved values without recalculating tax. |
| Compare emails | Compare customer and admin email values against the order and refund records. | The accounting or ERP export matches WooCommerce net order revenue. |
Why this usually happens
- Checkout blocks, order storage, refunds, and email rendering can read totals at different times.
- Template overrides may calculate tax again instead of displaying saved order values.
- Role-based tax plugins can apply exemptions differently in admin-created and customer-created orders.
- Cached checkout fragments can make a corrected calculation look inconsistent during testing.
Useful command or data shape
Adapt paths, IDs, and privacy handling to the site before running commands or storing data on production.
wp wc order get 10452 --user=1 --fields=id,status,total,total_tax,currency
wp post meta get 10452 _order_tax
wp post meta get 10452 _order_total
# Compare the values with the email log and accounting export.
Safe fix order
Do the work in a sequence that makes each result easy to prove. Stop if a step produces new evidence that changes the incident scope.
- Build test order
- Capture totals
- Test refunds
- Compare emails
- Reconcile exports
What to tell the client or owner
Record the customer role, address, cart, tax class, order ID, refund ID, and email log ID so the store owner can reproduce the proof.
Production verification checklist
- Checkout and saved order totals match for the tax-exempt customer.
- Partial and full refunds preserve the intended tax treatment.
- Customer and admin emails display saved values without recalculating tax.
- The accounting or ERP export matches WooCommerce net order revenue.
Mistakes to avoid
- Do not judge the fix by one browser or the homepage only.
- Do not delete evidence before recording usernames, file paths, timestamps, and response headers.
- Do not add a cache, security, or tracking plugin while the original problem is still unclear.
- Do not leave test users, temporary debug logs, or broad API keys active after verification.
When HandL WP should help
Bring in help when this affects leads, checkout, search visibility, malware risk, paid media reporting, or a client production site. HandL WP can trace the issue through WordPress, hosting, cache, tracking, and Search Console, then verify the workflow after the technical fix.
If this is active on a production site, get help testing WooCommerce checkout and order totals.
Related HandL WP guides
Use these related guides when the same issue touches tracking, security, checkout, or crawler visibility.
Helpful references