Declare the amount basis
Tell the API whether the amount already includes VAT; this determines whether VAT is added or extracted.
Calculate gross, net, and VAT
VAT calculation API
Send an amount, country, tax class, supply date, and price-inclusion context to receive a calculation built for repeatable system integration.
What this helps you do
Keep checkout and reporting arithmetic consistent while retaining the inputs needed to understand a result later.
- Gross-inclusive and net-exclusive calculation paths.
- Minor-unit arithmetic to avoid floating-point rounding errors.
- Tax-class and recorded-date context returned with the calculation.
- Optional transaction records for account-owned audit views.
How to use it well
Send money in minor units
Use integer cents or the currency’s minor unit in system integrations to avoid binary floating-point rounding drift.
Treat arithmetic and tax treatment separately
A correct gross/net calculation still depends on a reviewed country, rate, product classification, and date.