Overview of Changes
Starting with API version 2026-01, Shopify's tax_summaries/create webhook and tax calculation requests for Tax Partner Apps now include detailed multi-currency support. This update adds fields to provide amounts in both shop currency and presentment currency, improving accuracy for tax calculations and reporting.
Why This Matters
This enhancement enables tax partners to:
- Calculate taxes in the merchant's accounting currency (shop currency).
- Maintain accuracy for customer-facing transactions in presentment currency.
- Streamline reporting for merchants operating in multi-currency environments.
What's New in the Payload
New currency-specific fields have been added to the webhook and tax calculation request payloads in the following locations:
Sale Records
- Location: agreements[].sales[].amount_before_taxes_after_discounts_currencies
- Details: A MoneyBag object providing sale amounts before taxes in both shop and presentment currencies.
Cart Line Costs
- Location: delivery_groups[].cart_lines[].cost.amount_per_quantity_currencies
- Details: A MoneyBag object that includes per-unit costs in shop and presentment currencies.
These fields are available for shops with multi-currency enabled and complement the existing single-currency fields.
Understanding the MoneyBag Structure
The newly added MoneyBag fields consist of two MoneyV2 objects for each currency type. Below is example data illustrating the changes:
Before (API version 2025-10 and earlier)
{ "amount_before_taxes_after_discounts": { "currency_code": "CAD", "amount": "135.00" } }After (API version 2026-01)
{ "amount_before_taxes_after_discounts": { "currency_code": "CAD", "amount": "135.00" }, "amount_before_taxes_after_discounts_currencies": { "shop_currency": { "currency_code": "USD", "amount": "100.00" }, "presentment_currency": { "currency_code": "CAD", "amount": "135.00" } } }Conclusion
By adding detailed currency information to sale records and cart line costs, Shopify provides merchants and tax partners with enhanced tools for accurate reporting and cross-currency tax calculations. These improvements help support seamless multi-currency operations for global businesses.