Introducing Multi-Currency Support for API Requests

Executive summary:

• API version 2026-01 introduces new currency fields for webhooks.
• These changes improve tax calculation and reporting accuracy.
• Applicable for enterprise merchants with multi-currency enabled.

What changed

The latest Shopify API update enhances the tax_summaries/create webhook and tax calculation requests by adding fields for currency conversions. With these updates, the system now includes the MoneyBag object that stores transaction amounts in both shop and presentment currencies, specifically within Sale Records and Cart Line Costs.

Why it matters

For Shopify Plus merchants operating in multiple currencies, these changes streamline processes by allowing tax calculations in the shop's default accounting currency while displaying prices in the customer's preferred currency. This dual visibility supports accurate financial reporting and enhances customer experience.

Role-specific impact

• Marketers: Can confidently create promotions knowing tax calculations are precise across customer segments.
• Developers: Must adapt integrations to handle additional currency data for API requests.
• Store admins: Will benefit from improved financial accuracy and transparency in multi-currency operations.

Use-case example

Real-world scenario & metric

A global e-commerce retailer can now process tax requests in USD for accounting, while customers see prices in EUR, ensuring that financial records match internal and external perceptions, reducing errors in currency conversions by up to 30%.

Implementation checklist

1. Review the MoneyBag documentation.
2. Update API calls to include new currency fields.
3. Test webhook payloads for accuracy in tax calculations.
4. Train financial teams on interpreting multi-currency reports.
5. Consult with Makro experts for seamless transition.

FAQ

Q: How do these changes affect non-multi-currency merchants?
A: Single currency merchants will not see changes; the enhancements only apply when multi-currency is active.

Q: Do I need to update all existing webhooks?
A: Only update webhooks impacted by new currency information in tax calculations.

Resources

For more details, read the full MoneyBag documentation.

Need guidance? Talk to Makro.