‹ All updates

Send sales in other currencies, with commissions before tax

Sales in other currencies are converted to USD when recorded, and commissions and platform fees use the price after discounts and before tax.

Action required. Developers: If you report refunds through the API, send refund_amount_cents in the sale's own currency and minor unit, or leave it out to refund the whole sale. A value of 0 is no longer accepted for sales from November 5.
FeatureBrandsDevelopersTrackingAPI

Send sales in other currencies, and send the tax inside each sale. Starting Thursday, November 5, 2026 (16:00 UTC), we handle tax and currency differently in commissions and platform fees on new sales.

Until now, a sale sent through the API was commissioned on the amount as sent: amounts were not converted between currencies, and tax_cents was accepted but not used. Now the currency and the tax both count.

How it works

  • Commissions and platform fees are calculated on the price your customer paid after discounts and before tax, whenever your payment provider or your API call gives us the tax amount.
  • Sales in other currencies are converted to USD at the latest daily exchange rate when the sale is recorded, and we keep the original amount next to it.
  • Commissions already recorded do not change.

Send the tax with each sale

If your amount includes tax, add the tax in the tax_cents field of POST /api/v1/track/sale, in the same unit as amount_cents. Set currency to the sale's own currency:

{
  "transaction_id": "txn_abc123",
  "customer_key": "usr_9876",
  "amount_cents": 490000,
  "tax_cents": 40000,
  "currency": "VND"
}

Despite its name, amount_cents uses the currency's minor unit, not always hundredths: USD 49.00 is 4900, VND 490,000 is 490000, and BHD 1.234 is 1234. A currency we do not support returns 422 unsupported_currency and creates no sale.

What to do

If you report refunds, send refund_amount_cents in the sale's own currency and minor unit, or leave it out to refund the whole sale. A value of 0 is no longer accepted for sales from November 5: 0, a negative number or a non-integer returns 400 invalid_request. Refunds of earlier sales work as before.

curl -X POST https://api.affitor.com/api/v1/track/refund \
  -H "Authorization: Bearer YOUR_PROGRAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transaction_id":"txn_abc123","refund_amount_cents":10000,"refund_id":"re_123"}'

Conclusion

From November 5, tax and currency count in commissions and platform fees on new sales. Learn more in Track Sale and Track Refund, and write to support@affitor.com with any question.