Announcement: Adjustment to the PretaxAmount return logic in billing APIs
Dec 09, 2025
Alibaba Cloud International Site ConsoleAffected Time
Overview
To improve billing data consistency and transparency, Alibaba Cloud will update the logic for the PretaxAmount(amount payable before tax) field in select billing APIs. Starting January 6, 2026, this field will return the value in the pricing currency (USD) instead of the customer's payment currency (such as HKD or MYR).
Adjustment details
Previous logic
Return value: Pre-tax amount payable before tax in payment currency.
Description: The amount is converted into the currency used for payment, such as HKD or MYR.
New logic
Return value: Pre-tax amount payable before tax in the pricing currency.
Description: The amount is based on the original Alibaba Cloud pricing currency (USD).
Impact of the change
Scope of impact: Applies only to API calls made beginning 00:00 onJanuary 6, 2026.
Affected APIs: The PretaxAmount field in the following APIs will be updated:
- Split bill APIs: QuerySplitItemBill, DescribeSplitItemBill
- Instance bill APIs: QueryInstanceBill, DescribeInstanceBill
- Account bill APIs: QueryAccountBill
Example scenario Consider a resource priced at USD 100.25 where the customer pays in HKD (Exchange rate: USD 1 = HKD 7.78).
Response before adjustment"PretaxAmount": 779.95 // Returns HKD value (100.25 * 7.78) = HKD 779.945, rounded to HKD 779.95
Response after adjustment"PretaxAmount": 100.25 // Returns USD value (Original Price)
Future enhancement: precision increase
Following this adjustment, a subsequent phased rollout will increase the decimal precision of the pricing currency amount. Namely, the decimal precision will be increased from 2 decimal places to support up to 10 decimal places. For details about this enhancement, refer to the official announcement.
Actions required
Please review your application logic and billing reconciliation scripts. If your systems rely on PretaxAmount being in your payment currency, you may need to apply exchange rates manually or adjust your reporting logic before January 6, 2026.
If you have any questions, please contact us via a support ticket.