Samir Sabri

<p><strong>TaxDebug for WooCommerce</strong> helps store owners debug, understand, trust, and report their taxes – especially when using WooCommerce Tax (automated taxes) or other tax calculation services.</p>
<h4>Key Features</h4>
<p><strong>Deep Tax Visibility</strong><br />
* See exactly how taxes were calculated for every order<br />
* View applied tax rates, line-item breakdowns, and calculation formulas<br />
* Understand which service/plugin produced each tax amount (WooCommerce Core, WooCommerce Tax, TaxJar, Avalara)</p>
<p><strong>Issue Detection Engine</strong><br />
* Automatically detect common tax problems:<br />
  * No tax collected where expected<br />
  * Tax charged in non-taxable regions<br />
  * Rate mismatches vs reference rates<br />
  * Missing local (county/city) taxes<br />
  * Tax changes between cart and checkout<br />
  * Suspected API errors</p>
<p><strong>Beautiful Dashboard & Reports</strong><br />
* Modern, responsive admin interface<br />
* Interactive charts showing tax by state, country, and over time<br />
* KPI cards for total tax, taxable sales, and effective rates<br />
* Powerful filtering by date, country, state, tax source, and more</p>
<p><strong>Order Explorer</strong><br />
* Search and filter all orders with tax data<br />
* View detailed tax debug information for any order<br />
* Identify orders with detected issues quickly</p>
<p><strong>Accountant-Friendly Exports</strong><br />
* Export summary reports by country/state<br />
* Export detailed order-level tax breakdowns<br />
* Export detected issues for review<br />
* CSV format compatible with Excel and accounting software</p>
<p><strong>Safe & Non-Intrusive</strong><br />
* Does NOT modify how taxes are calculated<br />
* Only observes, logs, and analyzes tax data<br />
* Works with any tax calculation method</p>
<p><strong>Feedback & Analytics</strong><br />
* In-app feedback widget to report false positives/negatives<br />
* Feature request and success story submissions<br />
* Privacy-first usage analytics (all data stored locally)<br />
* Deactivation survey to help improve TaxDebug<br />
* All feedback stored locally – no external tracking</p>
<h4>Compatibility</h4>
<p>TaxDebug works with:<br />
* WooCommerce Core tax rates<br />
* WooCommerce Tax (automated taxes via TaxJar)<br />
* TaxJar plugin<br />
* Avalara AvaTax<br />
* Other tax plugins</p>
<h4>Requirements</h4>
<ul>
<li>WordPress 5.8 or higher</li>
<li>WooCommerce 5.0 or higher</li>
<li>PHP 7.4 or higher</li>
</ul>
<h3>Privacy</h3>
<p>TaxDebug stores order tax data locally in your WordPress database. This includes:<br />
* Order IDs and dates<br />
* Customer billing/shipping addresses (country, state, city, postcode only)<br />
* Order totals and tax amounts<br />
* Tax calculation details</p>
<p>TaxDebug does NOT:<br />
* Store payment information<br />
* Store full customer names or personal details beyond address location</p>
<p>Data retention can be configured in Settings. You can also manually clear all logs at any time.</p>
<h4>Feedback Collection</h4>
<p>TaxDebug collects optional feedback to improve the plugin:</p>
<ul>
<li><strong>In-app feedback</strong>: Report false positives, false negatives, feature requests, or success stories</li>
<li><strong>Usage analytics</strong>: Anonymous local tracking of which features are used</li>
<li><strong>Deactivation survey</strong>: Optional one-question survey when deactivating</li>
</ul>
<p><strong>Local Storage</strong>: All feedback is always stored locally in your WordPress database.</p>
<p><strong>Optional Remote Sending</strong>: You can opt-in to send anonymous feedback to the developer to help improve TaxDebug. This is <strong>disabled by default</strong> and must be explicitly enabled in Settings.</p>
<h4>What IS Sent (When Opted-In)</h4>
<ul>
<li>Anonymous store UUID (random identifier, NOT your domain)</li>
<li>Feedback type and message</li>
<li>Your email (only if you voluntarily provide it)</li>
<li>Store country and currency</li>
<li>Active tax plugin (e.g., TaxJar, Avalara)</li>
<li>Plugin, WordPress, and WooCommerce versions</li>
<li>Daily aggregated counts: orders logged, issues detected, features used</li>
</ul>
<h4>What is NEVER Sent</h4>
<ul>
<li>Your site URL or domain name</li>
<li>Customer names, emails, or addresses</li>
<li>Order details, totals, or line items</li>
<li>Tax amounts or financial data</li>
<li>Any personally identifiable information (PII)</li>
</ul>
<h4>How to Disable Remote Sending</h4>
<p>Go to <strong>WooCommerce <span aria-hidden="true" class="wp-exclude-emoji">→</span> TaxDebug <span aria-hidden="true" class="wp-exclude-emoji">→</span> Settings</strong> and turn off “Send Anonymous Feedback”. You can do this at any time. Local feedback storage will continue to work.</p>
<h3>Developer Notes</h3>
<h4>Hooks & Filters</h4>
<p>TaxDebug provides several hooks for extensibility:</p>
<p><strong>Actions:</strong><br />
* <code>taxdebug_loaded</code> – Fired when TaxDebug is fully loaded<br />
* <code>taxdebug_order_logged</code> – Fired when an order is logged (params: log_id, order_id, payload)<br />
* <code>taxdebug_installed</code> – Fired on plugin installation<br />
* <code>taxdebug_logs_cleaned_up</code> – Fired when old logs are cleaned up</p>
<p><strong>Filters:</strong><br />
* <code>taxdebug_order_payload</code> – Filter the order payload before logging<br />
* <code>taxdebug_detected_issues</code> – Add custom issue detection rules</p>
<h4>REST API Endpoints</h4>
<p>TaxDebug provides a REST API under the <code>taxdebug/v1</code> namespace:</p>
<ul>
<li><code>GET /logs</code> – Get tax logs with filtering</li>
<li><code>GET /logs/{id}</code> – Get single log</li>
<li><code>GET /logs/order/{order_id}</code> – Get log by order ID</li>
<li><code>POST /logs/reanalyze/{order_id}</code> – Re-analyze an order</li>
<li><code>GET /issues</code> – Get detected issues</li>
<li><code>GET /stats/dashboard</code> – Get dashboard statistics</li>
<li><code>GET /stats/chart/time</code> – Get time series chart data</li>
<li><code>GET /stats/chart/state</code> – Get tax by state data</li>
<li><code>GET /stats/chart/country</code> – Get tax by country data</li>
<li><code>GET /export/summary</code> – Export summary CSV</li>
<li><code>GET /export/detailed</code> – Export detailed CSV</li>
<li><code>GET /export/issues</code> – Export issues CSV</li>
</ul>
<p>All endpoints require <code>manage_woocommerce</code> capability.</p>
<h4>Database Tables</h4>
<p>TaxDebug creates two custom tables:</p>
<ul>
<li><code>{prefix}taxdebug_logs</code> – Stores order tax log data</li>
<li><code>{prefix}taxdebug_issues</code> – Stores detected issues</li>
<li><code>{prefix}taxdebug_feedback</code> – Stores user feedback submissions</li>
<li><code>{prefix}taxdebug_analytics</code> – Stores usage analytics</li>
<li><code>{prefix}taxdebug_error_logs</code> – Stores internal error logs</li>
</ul>
<h4>WP-CLI Commands</h4>
<p>(Coming in future versions)</p>


TaxDebug for WooCommerce

A tax debugging and reporting tool for WooCommerce. Debug tax issues, understand calculations, and generate audit-ready reports.

Stripe Tax

<p><span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/wefsKltlSsQ?si=acCn_9odo65Tlyj7&version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></p>
<p>Use Stripe Tax for WooCommerce to enable automatic sales tax calculation and apply the accurate tax rate for all of the transactions of your online store. Learn more how Stripe calculates <a href="https://docs.stripe.com/tax/calculating" rel="nofollow ugc">sales tax, VAT, and GST</a>.</p>
<ul>
<li>
<p>Know where to register: Understand where you need to collect taxes so that you can activate tax collection in over 50 countries and all US states. Stripe Tax for WooCommerce supports both country and VAT OSS registrations in Europe, and country and provincial registrations in Canada.</p>
</li>
<li>
<p>Automate tax collection: Calculate and collect the correct amount of tax. Stripe Tax for WooCommerce supports sales tax collection on hundreds of products and services, and maintains updated tax rules and rates.</p>
</li>
<li>
<p>Reconcile transactions: Stripe Tax for WooCommerce summarizes reports to match formatting requirements for each filing location so you can file and remit taxes on your own, with your accountant, or with a preferred partner.</p>
</li>
</ul>
<p>Stripe Tax pricing is usage-based. For Stripe Tax for WooCommerce pricing, see the <a href="https://support.stripe.com/questions/understanding-stripe-tax-pricing" rel="nofollow ugc">API integration with Stripe Tax</a>.</p>
<p>Follow along below to learn how to install this connector and how to configure it.</p>
<h3>1. Install the Stripe Tax for WooCommerce</h3>
<p>Install this plugin and make sure it’s activated.</p>
<h3>2. Connect your Stripe account</h3>
<p>On your website’s dashboard, navigate to WooCommerce > Settings and select the Stripe Tax tab.
</p>
<p>In the latest version, you connect your account manually using API keys:</p>
<p>You can generate your API key from the Woo Commerce Tax Stripe App</p>
<p>Select Mode: Choose between Live mode for real transactions or toggle the switch if you are performing tests.</p>
<p>Enter Secret Key: Copy your Secret Key from your Stripe account and paste it into the Secret key field.</p>
<p>Note: If you are in Live mode, use your Live Secret Key. If you are testing, use your Test Secret Key.</p>
<p>Test Connection: Click the Test connection button located next to the input field to verify that the key is valid.</p>
<p>Save Changes: Once the connection is verified, scroll to the bottom of the page and click Save changes to finalize the setup.</p>
<h3>3. Configure your sales tax settings</h3>
<p>Tax settings must now be configured directly on the <a href="https://dashboard.stripe.com/settings/tax" rel="nofollow ugc">Stripe Dashboard</a>.</p>
<p>On the Stripe Tax tab, under Configure your sales tax settings, complete the following:</p>
<ol>
<li>
<p>Choose your default <a href="https://docs.stripe.com/tax/tax-codes" rel="nofollow ugc">product tax code</a>, which allows Stripe to calculate the tax rate for categories of products.</p>
</li>
<li>
<p>Choose your tax class for taxable fees. (Default is General – Services)</p>
</li>
<li>
<p>Click Save changes.</p>
</li>
</ol>
<p>On the Tax tab, you can decide if the prices you set for your products are inclusive or exclusive of tax.</p>
<h3>4. Manage tax registrations</h3>
<p>Sales tax calculation isn’t applied <a href="https://docs.stripe.com/tax/zero-tax#situations-where-stripe-calculates-zero-tax" rel="nofollow ugc">until you add registrations</a> for jurisdictions where you need to collect tax. Our <a href="https://docs.stripe.com/tax/monitoring" rel="nofollow ugc">monitoring tool</a> can help you understand where you might be registered or need to register.</p>
<p>If you’re already registered in certain jurisdictions and want to start collecting tax immediately, you can add those registrations to your configuration. You can only add tax registrations for <a href="https://docs.stripe.com/tax/supported-countries#supported-countries" rel="nofollow ugc">supported countries and registration types</a>. Some jurisdictions might require additional information.</p>
<h3>Add tax registration</h3>
<p>On the Stripe Tax tab, under Tax registrations, click Add new. Choose the jurisdiction from the dropdown, then click Save changes.</p>
<h3>Delete tax registration</h3>
<p>To delete a registration, hover over the registration, then click End immediately. To delete multiple registrations, select them from the list, then click End immediately from the Bulk actions dropdown.</p>
<h3>5. Configure product tax codes and customer tax settings (optional)</h3>
<p>You can configure tax codes for your products or tax settings for your customers.</p>
<h3>Product tax codes</h3>
<p>Stripe Tax can calculate the tax for each of your products based on the product tax code that you assign to it. If you don’t set a code per product, Stripe Tax uses the default <a href="https://docs.stripe.com/tax/tax-codes" rel="nofollow ugc">product tax code</a> that you selected during setup.</p>
<p>To set a tax code per product:</p>
<ol>
<li>
<p>Go to Products and select a product from the list.</p>
</li>
<li>
<p>On the Edit product page, in the Product data section, select a Stripe Tax – Product tax code for the product.</p>
</li>
<li>
<p>Click Update to save your selection.</p>
</li>
</ol>
<h3>Customer tax settings</h3>
<p>Stripe Tax can calculate the tax for each of your customers based on their tax status.</p>
<p>To update a user’s taxability:</p>
<ol>
<li>
<p>Go to Users and select a user from the list.</p>
</li>
<li>
<p>Under Stripe Tax Exemptions, select a Tax Status option for the user.</p>
</li>
<li>
<p>Click Update user to save your selection.</p>
</li>
</ol>
<p>Learn more about how the customer’s <a href="https://docs.stripe.com/tax/zero-tax#exempt-customers" rel="nofollow ugc">tax status</a> impacts sales tax calculation.</p>
<h3>6. Collect taxes</h3>
<p>To start collecting taxes:</p>
<ul>
<li>
<p>On the WooCommerce > General tab, select Enable tax rates and calculations, then click Save changes. This setting enables rate configuration and sales tax calculation during the checkout process.</p>
</li>
<li>
<p>On the WooCommerce > Stripe Tax tab, select Enable Stripe Tax, then click Save changes. This setting enables automatic sales tax calculation and collection on all transactions.</p>
</li>
</ul>
<h3>7. View tax reports</h3>
<p>After you start collecting taxes, this Stripe Tax connector sends the transactions to Stripe Tax. You can then access tax reports and exports in the <a href="https://dashboard.stripe.com/tax/registrations" rel="nofollow ugc">Stripe Dashboard</a>.</p>
<p>Learn more about the types of <a href="https://docs.stripe.com/tax/reports" rel="nofollow ugc">tax reports</a> available in Stripe Tax.</p>


Stripe Tax – Sales tax automation for WooCommerce

Stripe Tax for WooCommerce allows you to easily calculate and collect sales tax, VAT, and GST on WooCommerce orders.

TaxDebug for WooCommerce vs Stripe Tax – Sales tax automation for WooCommerce