Enhance Tax Partner Apps with Currency Fields

Executive summary:

• API update introduces currency fields for Tax Partner Apps.
• Facilitates consistent calculation and reporting in multiple currencies.
• Key for merchants using multi-currency setups.

What changed

Starting from API version 2026-01, the tax_summaries/create webhook and tax calculation requests for Tax Partner Apps have been enhanced to include additional fields for currency. This improvement delivers amounts in both shop currency and presentment currency. It allows tax partners to maintain customer-facing currency display while processing calculations in the merchant's primary currency for accounting.

Why it matters

This update is crucial for Shopify Plus merchants operating in multiple currencies. It allows more accurate financial reporting and tax calculations, ensuring compliance and financial transparency in different currency environments. Merchants can improve customer experience by aligning their display currency with the customer’s location while managing backend processes in their base currency.

Role-specific impact

• Marketers: Can focus more on strategy and less on cross-currency discrepancies.
• Developers: Will need to integrate the new fields into existing systems to leverage the full benefit.
• Store admins: Gain a more straightforward reporting process, ensuring accuracy across multiple currencies.

Use-case example

Real-world scenario & metric

Consider a Canadian merchant whose primary currency is CAD, serving global customers. With the updated webhook, they can seamlessly report and analyze tax data in CAD while displaying prices in USD for U.S. customers, ensuring clarity and boosting sales by aligning with customer expectations.

Implementation checklist

1. Update your Tax Partner Apps to API version 2026-01.
2. Integrate new fields into backend systems for tax calculations.
3. Test cross-currency functionality to ensure accuracy.

FAQ

Q: Do I need to change my current single-currency setup?
A: No, but leveraging this update is beneficial if you have a global customer base.

Q: How are the new fields structured?
A: They use the MoneyBag format, including both shop and presentment currencies.

Resources

For more detailed information, visit the official Shopify MoneyV2 documentation.

Need guidance? Talk to Makro.