This API allows the partner to retrieve a list of unsettled transactions (incl. Orders & Adjustments) generated by a seller, returning the detailed fee breakdown for a list of order ID and adjustment ID. For now, this API only returns transactions which were created after 2025.01.01. Once one transaction is settled, which won’t be returned by this API anymore, please get from Get Statement Transaction API. **Pay attention to that all data returned through this API is an estimated amount which subject to change before settlement and can only used for seller’s reference, final settlement amount per each transaction can only provided through statement related API.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Identifies the shop. Obtain it from the Get Authorized Shops API.
An opaque token used to retrieve the next page of a paginated result set. Retrieve this value from the result of the next_page_token from a previous response. It is not needed for the first page.
The number of results to be returned per page. Default: 20 Valid range: [1-100]
The returned results will be sorted by the specified field. Only supports order_create_time.
The sort order for the sort_field parameter.
Default: ASC
Possible values:
- ASC: Ascending order
- DESC: Descending order
Filter statements to show only those that are generated on or after the specified date and time. Unix timestamp. Note:statement_time_ge and statement_time_lt together constitute the creation time filter condition. - If statement_time_ge is filled but statement_time_lt is empty, statement_time_lt will default to the current time. - If statement_time_lt is filled but statement_time_ge is empty, statement_time_ge will default to 20250101.
The search range’s end time
Responses
Section titled “Responses”Success
object
Status code; 0 means success.
Success or failure message.
Request log ID.
object
An opaque token used to retrieve the next page of a paginated result set. If this value is present and non-empty, provide it in the page_token parameter of the next request and reuse the same shop context, explicit search_time_ge, search_time_lt, sort_field, and sort_order values. If this value is absent or empty, pagination is complete.
The total number of matching unsettled transaction records across all pages.
The sum of the estimated settlement amount.
The sum of the estimated revenue amount.
The sum of the estimated adjustment amount.
The sum of the estimated fee amount.
The list of transaction records in the statement. Each transaction corresponds to an order, an adjustment, or a reserve-related transaction.
object
The transaction type. Standard transactions
ORDER: A transaction related to an order settlement.- If the transaction is an adjustment, it returns one of the following values: Platform-related adjustments
CHARGE_BACK: Charges returned to a payment card after a customer has successfully disputed an item on their account statement or transactions report.CUSTOMER_SERVICE_COMPENSATION: Extra compensation or compensation paid to a customer after the after-sales period by customer service.DEDUCTIONS_INCURRED_BY_SELLER: Deduction arising from customer dissatisfaction as a result of the seller’s responsibility. This includes issues such as fraud, empty packages, items that do not match the product display page, or items of lower value than advertised.GMV_PAYMENT_FOR_ADS: Amount used to pay for your advertisement if you are enabled “auto pay ads with shop GMV”, or to pay for Tiktok Promote ads orders.PLATFORM_COMMISSION_ADJUSTMENT: Adjustment when there are differences in the platform commission paid by the seller.PLATFORM_COMMISSION_COMPENSATION: Compensation paid to the seller when there are differences in the platform commission paid by the seller.PLATFORM_PENALTY: Penalty imposed for a violation of TikTok Shop policies (the corresponding amount has been deducted from the seller’s account). For details, please refer to the email notification sent to the seller.PROMOTION_ADJUSTMENT: Adjustment when a seller takes part in a platform promotion and there are differences between the promotion price and the actual amount paid by the seller.REBATE: A discount on referral fees offered by TikTok Shop to eligible sellers.PLATFORM_COMPENSATION: Compensation paid to the seller after the seller successfully appealed for a customer dispute.PLATFORM_REIMBURSEMENT: Reimbursement paid by TikTok Shop for an order refunded under TikTok’s refund without return policy (the seller is not responsible). Logistics-related adjustmentsFBT_WAREHOUSE_SERVICE_FEE: Amount charged by TikTok Fulfillment Portal (Pipak) for warehousing-related bills incurred by the seller under the Fulfilled by TikTok (FBT) service.LOGISTICS_REIMBURSEMENT: Reimbursement paid by TikTok Shop for an order refunded due to logistics-related issues (e.g. lost or damaged order).SHIPPING_FEE_ADJUSTMENT: Adjustment when there are differences or mistakes with the shipping fee paid by the seller.SHIPPING_FEE_COMPENSATION: Compensation given to sellers due to differences between the actual shipping fee and the pre-paid shipping fee.SHIPPING_FEE_REBATE: Shipping fee rebate provided to the seller as part of their participation in a platform campaign.SAMPLE_SHIPPING_FEE: Fees charged for sending samples using the TikTok logistics provider. Miscellaneous adjustmentsOTHER_ADJUSTMENT: Adjustment for other reasons.
The transaction ID.
The transaction status. Only supports UNSETTLED.
The three-letter currency code in ISO 4217 format.
Estimated settlement time for the transaction. Possible return values:
- A relative settlement schedule, such as
Delivered + N days, when the order has not been delivered and only an approximate settlement policy is available. - A Unix timestamp in seconds when the order has been delivered and the estimated settlement time is available.
Reason for why transaction is pending for settlement
The time when the order was created, as a Unix timestamp in seconds.
The time when the order was delivered, as a Unix timestamp in seconds. No delivery time is available if the order has not been delivered.
The order ID. Each transaction can only be associated with an order ID or an adjustment ID.
The adjustment ID if the transaction is an adjustment. Each transaction can only be associated with an order ID or an adjustment ID.
The order ID associated with the adjustment, if any.
The estimated adjustment amount based on TikTok Shop policy.
Refer to transactions.type for the list of adjustment-related policies.
The estimated settlement amount for the order. Formula: revenue_amount - shipping_cost_amount - fee_tax_amount - adjustment_amount
The estimated revenue amount. This is equivalent to the sum of all amounts in revenue_breakdown.
The revenue amounts that directly contribute to est_revenue_amount.
object
The total price of all order items before any seller discounts and platform discounts are deducted. This is equivalent to the shop’s gross sales.
The total amount of discounts funded by the seller, including:
- Seller promotions (Product Discount, Flash Deal, Buy More Save More, Voucher and Bundle Deal)
- Seller’s portion of a co-funded voucher discount in co-funding campaigns
- Seller discounts during a campaign
The total price of all refunded items before any seller discounts. This is equivalent to the shop’s gross sales refund.
Discounts returned to the sellers due to returns or refunds.
The cash on delivery service fees charged to buyers. Applicable only for Saudi Arabia.
The refund for cash on delivery service fees. Applicable only for Saudi Arabia.
The distance fee for items paid by the customer. With your current settings for Horizon+ Program, this fee is included in product price for orders with shipping out of Java island.
The estimated shipping costs, please note that when order hasn’t been delivered, no complete shipping cost can be provided. This is equivalent to the sum of all contributory amounts in shipping_cost_breakdown.
The shipping cost amounts that directly contribute to est_shipping_cost_amount.
object
The actual shipping fee calculated based on the weight/dimensions measured by the carrier. For details, check shipping_cost_breakdown.supplementary_component.
The delivery fee charged to the seller for the international leg of a cross-border shipment
The shipping fee subsidies and incentives provided by the platform. This includes all subsidies regardless of fulfillment channels or policies. For details, check shipping_cost_breakdown.supplementary_component.
The actual shipping fee borne by the customer, calculated based on the product weight uploaded by the seller.
The shipping fee paid by the seller for the delivery of returns.
The shipping fee paid by the seller for the delivery of goods replacement. Applicable only for Indonesia.
The shipping fee paid by the seller for the delivery of goods exchange. Applicable only for Indonesia.
The fee incurred for packages requiring signature confirmation services
The shipping insurance fee incurred by the seller for purchasing additional TikTok shipping insurance services.
The distance fee for shipping paid by the customer. With your current settings for Horizon+ Program, this fee is included in product price for orders with shipping out of Java island.
Shipping App Service Fee for using shipping fee to generate shipping labels
A fee charged to sellers throughout the order lifecycle for logistics-related services, including processing, coordination, handling of delivery-related matters, and basic shipping incentives. It is an amount per order, which is based on the parcel’s weight tier and shipping route. It allows the platform to continuously enhance a high-quality, sustainable logistics network that serves both sellers and customers better over the long term, amidst changing global conditions.
Subsidy applied to your orders and offered to all FBT (Fulfilled by TikTok) merchants for the statement period. The amount is calculated based on your qualifying FBT order volume during this period.
Subsidy applied to your orders based on eligibility for the key merchant program. The amount is calculated based on your qualifying FBT (Fulfilled by TikTok) order volume during the statement period.
Supplementary shipping cost amounts for reference. These amounts do not directly contribute to est_shipping_cost_amount.
object
The fee to offset TikTok Shop Shipping Incentive or customer-paid shipping fee, resulting in a net charge of $0 to the seller. Applicable only for the US.
The shipping fee subsidy funded by the platform for seller shipping. This is part of shipping_fee_discount_amount.
- Positive amount represents a subsidy received by the seller.
- Negative amount represents a subsidy that the seller must return to TikTok Shop.
The shipping fee discount provided in accordance with a campaign policy.. This is part of shipping_fee_discount_amount.
The shipping fee incurred by the seller for using TikTok Shipping. This is part of actual_shipping_fee_amount.
The shipping fee incurred by the seller for orders fulfilled by TikTok (FBT). This is part of actual_shipping_fee_amount.
Applicable for all regions except the US.
The additional shipping incentive that the seller will receive if the seller signed up for the Co-Funded Free Shipping Program from 2024/08/26 to 2024/12/31. A negative amount indicates a reversal of incentives due to order refunds attributed to the seller’s responsibility. This is part of shipping_fee_discount_amount.
The shipping and warehouse fulfillment fee incurred by the seller for orders fulfilled by TikTok (FBT). This is part of actual_shipping_fee_amount.
Applicable only for the US.
The shipping fee discount provided by sellers.
Reimbursement from the Shipping Fee Reimbursement Program for failed deliveries or returns.
The shipping fee incentive provided by TikTok Shop.
Fee charged when a parcel containing hazardous materials is shipped without the required declaration or compliant packaging, as assessed by the carrier. Charged when the parcel is delivered.
Fee charged for the additional handling required to ship a parcel containing hazardous materials. Charged when the parcel is delivered.
Fee charged when a parcel exceeds the standard weight range. The rate is set by TikTok Shop and charged when the parcel is delivered.
Fee charged when a parcel exceeds the standard size range. The rate is set by TikTok Shop and charged when the parcel is delivered.
The estimated total fees and taxes charged by TikTok Shop. Shipping-related costs are excluded. This is equivalent to the sum of all contributory amounts in fee_tax_breakdown.
The fee and tax amounts that directly contribute to est_fee_tax_amount.
object
The fee amounts that contribute to est_fee_tax_amount.
object
The commission amount charged by the platform.
The referral fee charged for processing successful orders. Applicable only for the US.
The 20% refund administration fee deducted from the total refunded referral fee amount.
The transaction fee charged for processing successful orders.
The handling fee charged when the buyer pays with a credit card.
The commission amount charged to the seller for payment to the creator.
The affiliate ads commission paid to a creator before any personal income tax withholding. Applicable only for SEA markets.
The creator’s personal income tax withholding amount, deducted from the affiliate ads commission. Sellers are responsible for declaration and remittance to the tax authority, as well as providing finalized personal income tax documentation to creators. Applicable only for SEA markets.
The commission amount for purchases through affiliate partner links.
The commission for eligible orders from ads.
The service fee charged for participation in the [Seller Free Shipping Programme].
The service fee charged for participation in the [LIVE Specials Programme].
The service fee charged for participation in the bonus cashback program.
The service fee charged for using TikTok Shop Mall.
The final retail delivery fee for deliveries in Colorado, US. For more information, see Colorado Retail Delivery Fee FAQ.
Formula: retail_delivery_fee_payment_amount + retail_delivery_fee_refund_amount
The retail delivery fee for deliveries in Colorado, US. For more information, see Colorado Retail Delivery Fee FAQ.
The retail delivery fee subsidy by the platform for losses due to returns, refunds, or other issues in Colorado, US.
The portion of the Distance Shipping Fee paid by the customer that exceeds the logistics service provider’s charge, retained by TikTok Shop to support a secure fulfillment experience
This fee includes funds from TikTok Shop to help provide promotions to customers
Infrastructure fees are a fixed service fee that TikTok Shop charges for providing, maintaining, and developing infrastructure for delivery services. It applies to delivered orders on the main order level.
The dynamic commission fee is the amount that the platform charges to all sellers for every successfully delivered order. Applicable only for Indonesia.
Fee charged during Co-funded Promotion campaigns.
Fee charged during Smart Promotion campaigns.
Sales tax applied to the campaign period fee under Smart Promotion.
Sales tax applied to the campaign period fee under Co-funded Promotion.
A fee charged on each successful order to provide Bonus Cashback and other growth benefits.
Shipping fee for order that failed to be delivered to the customer. In some cases, the fee may be shared between seller and platform.
Shipping fee for buyer-fault returns. In some cases, the fee may be shared between seller and platform.
Premium charged per order for insurance coverage
Sales tax applied to GMV Max ad fee
Tax applied to the shipping protection fee.
Fee for using the New Customer Growth Package to offer discounts that attract new customers to your shop.
Fee for using the Product GMV Growth Package to offer discounts on selected products and increase their sales.
Fee for using the Shop GMV Growth Package to offer store-wide discounts and grow your overall sales.
The commission fee charged to the seller for orders attributed to the AI-generated, auto-post shoppable videos.
Service fee charged for seller-funded user S-Points issued to shoppers. Calculated based on the order’s actual payment amount and refunded if the order is later returned.
The service fee charged for participation in flash sales.
The tax amounts that contribute to est_fee_tax_amount.
object
The final sales tax to be paid by the customer for the product and delivery. Formula: sales_tax_payment_amount - sales_tax_refund_amount
The expected sales tax to be paid by the customer for the product and delivery.
The sales tax amount returned to the customer in the event of a refund.
The VAT paid by the platform on the seller’s behalf. Applicable only for cross-border shop orders.
The import VAT, a tax paid on goods bought in one country and imported into another. Applicable only for cross-border shop orders.
The customs duties, a type of tax on cross-border goods collected by governments. Applicable only for cross-border shop orders.
The fees charged by logistic suppliers for customs clearance services. Applicable only for cross-border shop orders.
The sales and service tax (SST) collected and remitted to the tax authority by the platform for low-value goods imported into Malaysia, effective January 1, 2024.
The goods and services tax (GST) collected and remitted to the tax authority by the platform for low-value goods imported into Singapore, effective January 1, 2023.
Some U.S. states consider referral fees taxable. To comply with state tax laws, TikTok Inc. collects and remits applicable sales tax when a taxable fee is charged.
The sales tax applied to the Smart Promotion fee.
The Mexican Guanajuato cedular tax
The sales tax applied to the New Customer Growth Package fee.
The sales tax applied to the Shop GMV Growth Package fee.
The sales tax applied to the Product GMV Growth Package fee.
The sales tax applied to the auto-post shoppable video commission fee.
Example
{ "code": 0, "data": { "next_page_token": "6AsPQsUMvH3RkchNUPPh22NROHkE0D8pmq/N5M1kHYcZmtRyv9aVrNv65W7Q6tFA+7D1ud64MPNz5OaT", "total_count": 2, "sum_est_settlement_amount": "100", "sum_est_revenue_amount": "10", "sum_est_adjustment_amount": "-10", "sum_est_fee_amount": "-10", "transactions": [ { "type": "ORDER", "id": "1636700041413599290", "status": "UNSETTLED", "currency": "USD", "estimated_settlement": "1685548800", "unsettled_reason": "waiting for deliveery", "order_create_time": 1685548800, "order_delivery_time": 1685548800, "order_id": "576463220456522968", "adjustment_id": "7238804564097517332", "adjustment_order_id": "576463220456522968", "est_adjustment_amount": "170", "est_settlement_amount": "130", "est_revenue_amount": "200", "revenue_breakdown": { "subtotal_before_discount_amount": "210", "seller_discount_amount": "-10", "refund_subtotal_before_discount_amount": "0", "seller_discount_refund_amount": "0", "cod_service_fee_amount": "0", "refund_cod_service_fee_amount": "0", "distant_item_fee_amount": "0" }, "est_shipping_cost_amount": "-70", "shipping_cost_breakdown": { "actual_shipping_fee_amount": "-50", "international_leg_logistics_amount": "0", "shipping_fee_discount_amount": "50", "customer_paid_shipping_fee_amount": "70", "return_shipping_fee_amount": "-10", "replacement_shipping_fee_amount": "-10", "exchange_shipping_fee_amount": "-10", "signature_confirmation_fee_amount": "-5", "shipping_insurance_fee_amount": "-5", "distant_shipping_fee_amount": "0", "shipping_app_service_fee_amount": "0", "logistics_service_fee": "0", "fbt_overall_merchant_subsidy": "0", "fbt_key_merchant_subsidy": "0", "supplementary_component": { "customer_shipping_fee_offset_amount": "-6.99", "shipping_fee_subsidy_amount": "0", "platform_shipping_fee_discount_amount": "20", "fbm_shipping_cost_amount": "0", "fbt_shipping_cost_amount": "0", "promo_shipping_incentive_amount": "30", "fbt_fulfillment_fee_amount": "-50", "seller_shipping_fee_discount_amount": "0" }, "sfr_reimbursement": "0", "tiktok_shop_shipping_incentive_amount": "0", "hazmat_noncompliance_fee": "0", "hazmat_handling_fee": "0", "non_standard_weight_fee": "0", "non_standard_dimension_fee": "0" }, "est_fee_tax_amount": "-30", "fee_tax_breakdown": { "fee": { "platform_commission_amount": "0", "referral_fee_amount": "-2", "refund_administration_fee_amount": "0", "transaction_fee_amount": "-2", "credit_card_handling_fee_amount": "-2", "affiliate_commission_amount": "-4", "affiliate_commission_before_pit_amount": "-6", "pit_withheld_from_ads_commission_amount": "2", "affiliate_partner_commission_amount": "0", "affiliate_ads_commission_amount": "-3", "sfp_service_fee_amount": "0", "live_specials_fee_amount": "0", "bonus_cashback_service_fee_amount": "0", "mall_service_fee_amount": "0", "retail_delivery_fee_amount": "0", "retail_delivery_fee_payment_amount": "0", "retail_delivery_fee_refund_amount": "0", "platform_special_service_fee_amount": "0", "smart_promotion_fee_amount": "0", "vn_fix_infrastructure_fee": "0", "dynamic_commission_amount": "0", "campaign_period_fee_cfp_amount": "0", "campaign_period_fee_sp_amount": "0", "campaign_period_fee_sp_tax_amount": "0", "campaign_period_fee_cfp_tax_amount": "0", "seller_growth_fee_amount": "0", "failed_delivery_shipping_fee": "0", "buyer_fault_return_shipping_fee": "0", "insurance_fee": "0", "cps_shop_ads_commission_tax_amount": "0", "shipping_insurance_fee_tax_amount": "0", "new_customer_growth_package_fee": "0", "target_product_gmv_growth_package_fee": "0", "store_gmv_growth_package_fee": "0", "auto_post_shoppable_video_commission_fee": "0", "seller_funded_user_spoint_service_fee": "0", "flash_sales_service_fee_amount": "0" }, "tax": { "sales_tax_amount": "-10", "sales_tax_payment_amount": "10", "sales_tax_refund_amount": "0", "vat_amount": "0", "import_vat_amount": "0", "customs_duty_amount": "0", "customs_clearance_amount": "0", "sst_amount": "0", "gst_amount": "0", "sales_tax_referral_fee_amount": "0", "smart_promotion_fee_tax_amount": "0", "cedular_tax": "0", "new_customer_growth_package_fee_tax": "0", "store_gmv_growth_package_fee_sales_tax": "0", "target_product_gmv_growth_package_tax": "0", "auto_post_shoppable_video_sales_tax": "0" } } } ] }, "message": "Success", "request_id": "202203070749000101890810281E8C70B7"}