For All Markets : New properties added to Finance transaction APIs

Overview

Three Finance transaction APIs are getting new return properties. The change is additive and backward compatible — no existing field is removed or modified. The affected APIs are:

• Get Transactions by Order
• Get Transactions by Statement
• Get Unsettled Transaction

In summary, the three new properties are:

• tiktok_shop_shipping_incentive_amount — the shipping incentive granted by the platform to the merchant.
• cps_shop_ads_commission_tax_amount — the tax charged on the commission of CPS Shop Ads.
• gmv_max_coupon_fee — the coupon fee associated with GMV Max (QCPX) advertising.
• shipping_insurance_fee_tax_amount— Tax applied to the shipping protection fee.

Get Transactions by Order

Adds three new amount properties to the transaction object:

Get Transactions by Statement

Adds three new amount properties to the transaction object:

Get Unsettled Transaction

Adds two new amount properties to the transaction object:

Note: Get Unsettled Transaction does not include gmv_max_coupon_fee.

The new properties apply to the markets and merchants below. Each property returns a non-zero value only when the corresponding fee/incentive occurs; otherwise it returns 0 and there is no impact.

This change applies automatically on the effective date. No API version upgrade or declaration is required. Ensure your JSON parsing tolerates the new fields, then include the new amounts in reconciliation and reporting where relevant.