Update 02.10.2025: New VAT fields on Order Item & Order objects

ℹ️This change was deployed on 22.09.2025.

We’ve extended the OrderItem and Order schemas to include detailed VAT information. These additions allow you to track and reconcile VAT amounts both in presentation (customer-facing) and settlement contexts.

What’s new

In OrderItem

• vat_rate (string) — the percentage VAT rate applied to this item, e.g. "25.00".
• vat_country (string) — the country code for the VAT jurisdiction, e.g. "DK".
• vat_charged (string) — the VAT charged to the customer in the order currency, e.g. "465.20".
• settlement_vat_charged (string) — the VAT amount recognized for settlement (payout) purposes, e.g. "62.31".

In Order

• total_vat_charged (string) — the sum of all vat_charged across order items.
• total_settlement_vat_charged (string) — the sum of all settlement_vat_charged across order items.

Backwards compatibility & migration notes

• Existing integrations will continue to function without disruption — the new fields are optional and do not break prior contracts.

Why this change?

This enhancement provides improved transparency and reconciliation:

• Better accounting support and auditability, especially in multi-jurisdiction / cross‐border setups.
• Helps prepare for evolving tax regulations or marketplace-level withholding/settlement VAT rules.