Introduce enhanced tax webhook fields for currency

Executive summary:

• Enhancement of the tax_summaries/create webhook and tax calculation requests with additional currency fields.
• Provide tax calculations in both shop and presentment currencies for streamlined financial operations.
• Supports multi-currency operations for Shopify Plus merchants dealing with global clientele.

What changed

Starting with API version 2026-01, the tax_summaries/create webhook and tax calculation requests for Tax Partner Apps are enhanced with new fields showing monetary amounts in both the shop's currency and the presentment currency. These changes utilize the MoneyBag structure for better currency differentiation in financial reporting.

Why it matters

This update is significant for Shopify Plus merchants who operate in multiple currencies. By clearly differentiating between the shop and presentment currencies, businesses can maintain consistency in customer experience while accurately fulfilling backend financial reporting and accounting requirements. This seamless currency management ensures that merchants can handle international transactions more effectively.

Role-specific impact

• Marketers: Can offer prices in multiple currencies, ensuring a localized and appealing experience for customers across different regions.
• Developers: Gain access to clear and structured monetary data in API responses, facilitating custom solutions and integrations.
• Store admins: Maintain accurate financial reports that reflect the true financial position of the store across different currencies.

Use-case example

Real-world scenario & metric

Consider a Shopify Plus merchant selling in North America and Europe. With the new fields, their tax reports can show amounts in both USD (shop currency) and EUR (presentment currency). Consequently, their financial statements are reconciled accurately in both regions, reducing accounting discrepancies and enhancing operational efficiency.

Implementation checklist

1. Update your API to version 2026-01.
2. Review the MoneyBag structure for implementation details.
3. Test the new webhook fields in your tax applications.
4. Integrate with your existing accounting and reporting systems to utilize both currency fields.

FAQ

Q: Do I need to update my applications to use these new fields?
A: Yes, updating your applications to handle these fields is essential for full utilization.

Q: Will this impact my existing single-currency setups?
A: Only if you opt to enable multi-currency features; existing setups will remain unaffected unless explicitly updated.

Resources

To learn more, visit the MoneyV2 API documentation.

Need guidance? Talk to Makro.