Retrieves the SKU-level details of an order transaction. This covers transactions related to sales, fees, commissions, shipping, taxes, and refunds. Applicable for all regions’ sellers. Only data after 2023-07-01 is available (Please note that for US cross-border sellers, data before 2025-04-30 is unavailable).
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”The order ID in TikTok Shop.
Query Parameters
Section titled “Query Parameters”Identifies the shop. Obtain it from the Get Authorized Shops API.
Responses
Section titled “Responses”Success
object
Status code; 0 means success.
Success or failure message.
Request log ID.
object
The order ID in TikTok Shop.
The creation time of the order, as a Unix timestamp in seconds.
The three-letter currency code in ISO 4217 format.
The revenue amount for the order at the time of order settlement. This is equivalent to the net sales amount.
The fees and taxes charged by the platform for the order at the time of order settlement. Shipping-related costs are excluded.
The shipping costs for the order at the time of order settlement.
The settlement amount for the order.
Formula: revenue_amount - shipping_cost_amount - fee_tax_amount
The list of SKU transaction records for the order.
object
The SKU ID in TikTok Shop.
The SKU name.
The statement ID.
The product title.
The SKU quantity included in the order settlement.
The settlement amount for the SKU.
The revenue amount at the time of order settlement. This is equivalent to the sum of all amounts in revenue_breakdown.
An object containing the amounts that directly contribute to 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 shipping costs at the time of order settlement. This is equivalent to the sum of all contributory amounts in shipping_cost_breakdown.
An object containing the amounts that directly contribute to 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. Negative numbers refer to the refunded amount of customer-paid shipping fees
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.
A reimbursement from TikTok Shop for Fulfilled by TikTok (FBT) orders that don’t qualify for free shipping. Applicable only for the US.
The fee borne by the customer to cover the cost of return labels. This fee is collected on the seller’s behalf and settled according to the agreed payment terms.
A service fee charged for orders shipped through your own logistics provider. Applies to packages that don’t meet the exemption criteria.
Reimbursement for the shipping fees paid by customers to return packages
For shipping fee from failed deliveries, you pay up to a standard rate, and TikTok Shop covers the remaining amount.
This is the fee that you cover when offering customers free shipping through FBT.
Reimbursement for the platform-funded portion of return shipping fees, as part of the free returns offered to customers.
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.
The shipping fee incentive provided by TikTok Shop.
Supplementary costs for your reference. These amounts do not directly contribute to shipping_cost_amount.
object
(Deprecated: This field is deprecated and will return an empty string. Please refer to shipping_cost_breakdown.fbt_fulfillment_fee_reimbursement_amount instead for the relevant details.)
The shipping fee discount provided in accordance with a campaign policy. This is part of shipping_fee_discount_amount.
The additional shipping incentive that the seller will receive if the seller signed up for the Co-Funded Free Shipping Program. 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 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 by sellers.
The shipping fee incurred by the seller for orders fulfilled by TikTok (FBT). This is part of actual_shipping_fee_amount.
Applicable only for EU and UK.
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 incurred by the seller for using TikTok Shipping. This is part of actual_shipping_fee_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.
For shipping fee from returns and refunds, you pay up to a standard rate, and TikTok Shop covers the remaining amount.This is part of customer_paid_shipping_fee_amount.
Shipping fee returned to customers due returns and refunds.Does not include subsidies.This is part of customer_paid_shipping_fee_amount.
Reimbursement from the Shipping Fee Guarantee Program for failed deliveries or returns
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 total fees and taxes charged by TikTok Shop at the time of order settlement. Shipping-related costs are excluded. This is equivalent to the sum of all contributory amounts in fee_tax_breakdown.
An object containing the fee and tax amounts that directly contribute to fee_tax_amount.
object
An object containing the fee amounts that contribute to fee_tax_amount.
object
The commission amount charged by TikTok Shop.
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 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 service fee charged for participation in the Voucher Xtra program.
The service fee charged for participation in flash sales.
The service fee charged for co-funded promotions.
The service fee charged when seller joins Pre-order program.
The commission amount charged by TikTok Shop Partners (TSP).
The handling fee charged for orders that are fulfilled by Dilayani Tokopedia.
The eco-contributions TikTok Shop pays on your behalf to the qualified producer responsibility organization (PRO).
The fee charged to sellers by the platform for each item sold. Applicable only for the Brazil market.
The handling fee charged to the seller for participation in the PayLater program.
The portion of the creator bonus that you co-fund as part of the commission boost campaign.
The dynamic commission fee is the amount that the platform charges to all sellers for every successfully delivered order. Applicable only for Indonesia.
The service fee for participating in the External Affiliate Marketing Solution Program, as stated during registration.
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 amount reserved for creator commissions after an order is paid. Applies only to commissions tied to order volume and is based on the highest earning rate.
The commission deposit refunded to you after order settlement. Applies only to commissions tied to order volume.
The advertising commission cost a merchant pays to TikTok Shop Affiliate Partner (TAP).
A flat service fee charged for each order under the Shipping Fee Guarantee Program
The fee TikTok Shop charges you for using platform installation service
Amount of campaign resource fee from program seller joining in
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
A percentage deducted from your net sales per order for GMV Max (net sales performance goal) advertising.
Calculated as a percentage of (original price − seller discount + customer-paid shipping fee).
This amount is collected on behalf of the government.
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.
Fee charged for participating in the Category-led campaign.
Sales tax charged for the fee.
Commission fee charged for participating in the Brand Amplification Program.
Sales tax charged for the fee.
Fee charged for participating in the Brand campaign.
Sales tax charged for the fee.
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
The cost of GMV Max coupons.
Sales tax applied to GMV Max ad fee
The tax amount charged on the shipping insurance 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.
An object containing the tax amounts that contribute to fee_tax_amount.
object
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. In Japan, it refers to the Japan Consumption Tax (JCT).
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.
The Mexican VAT that TikTok Shop is required to withhold on your taxable products and remit to the tax authority.
The Mexican federal income tax that TikTok Shop is required to withhold.
The anti-dumping duties collected by governments for import goods.
The VAT paid by the platform on the seller’s behalf. Applicable only for local shop orders.
The personal income tax (PIT) paid by the platform on the seller’s behalf.
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.
Sales tax for 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.
Article 22 Income Tax withheld by the platform under PMK 37/2025
The number of transaction records
Example
{ "code": 0, "data": { "order_id": "5793990727963214852", "order_create_time": 1685548800, "currency": "GBP", "revenue_amount": "200", "fee_and_tax_amount": "-30", "shipping_cost_amount": "-70", "settlement_amount": "130", "sku_transactions": [ { "sku_id": "1636700041413599290", "sku_name": "Test SKU name", "statement_id": "7238804564097517339", "product_name": "Test Product name", "quantity": "1", "settlement_amount": "130", "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" }, "shipping_cost_amount": "-70", "shipping_cost_breakdown": { "actual_shipping_fee_amount": "-50", "international_leg_logistics_amount": "0", "shipping_fee_discount_amount": "0", "customer_paid_shipping_fee_amount": "0", "return_shipping_fee_amount": "-10", "replacement_shipping_fee_amount": "-10", "exchange_shipping_fee_amount": "5", "signature_confirmation_fee_amount": "5", "shipping_insurance_fee_amount": "0", "fbt_fulfillment_fee_reimbursement_amount": "5", "return_shipping_label_fee_amount": "5", "seller_self_shipping_service_fee_amount": "5", "return_shipping_fee_paid_buyer_amount": "5", "failed_delivery_subsidy_amount": "5", "fbt_free_shipping_fee_amount": "5", "free_return_subsidy_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", "tiktok_shop_shipping_incentive_amount": "0", "supplementary_component": { "fbt_fulfillment_fee_reimbursement_amount": "5", "platform_shipping_fee_discount_amount": "20", "promo_shipping_incentive_amount": "0", "shipping_fee_subsidy_amount": "0", "seller_shipping_fee_discount_amount": "0", "fbt_shipping_cost_amount": "-30", "customer_shipping_fee_offset_amount": "-6.99", "fbm_shipping_cost_amount": "30", "fbt_fulfillment_fee_amount": "0", "return_refund_subsidy_amount": "0", "refunded_customer_shipping_fee_amount": "0", "shipping_fee_guarantee_reimbursement": "0" }, "hazmat_noncompliance_fee": "0", "hazmat_handling_fee": "0", "non_standard_weight_fee": "0", "non_standard_dimension_fee": "0" }, "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": "0", "affiliate_commission_amount": "0", "affiliate_commission_amount_before_pit": "-2", "affiliate_partner_commission_amount": "0", "affiliate_ads_commission_amount": "0", "sfp_service_fee_amount": "2", "live_specials_fee_amount": "2", "bonus_cashback_service_fee_amount": "0", "mall_service_fee_amount": "0", "voucher_xtra_service_fee_amount": "100", "flash_sales_service_fee_amount": "50", "cofunded_promotion_service_fee_amount": "100", "pre_order_service_fee_amount": "10", "tsp_commission_amount": "10", "dt_handling_fee_amount": "10", "epr_pob_service_fee_amount": "-10", "fee_per_item_sold_amount": "0", "seller_paylater_handling_fee_amount": "-10", "cofunded_creator_bonus_amount": "-10", "dynamic_commission_amount": "5", "external_affiliate_marketing_fee_amount": "10", "vn_fix_infrastructure_fee": "0", "affiliate_commission_deposit": "0", "affiliate_commission_release": "0", "tap_shop_ads_commission": "0", "shipping_fee_guarantee_service_fee": "0", "installation_service_fee": "0", "campaign_resource_fee": "0", "platform_special_service_fee_amount": "0", "smart_promotion_fee_amount": "0", "gmv_max_ad_fee_amount": "0", "platform_semi_managed_commission_fee": "0", "platform_semi_managed_commission_fee_tax": "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", "category_led_campaign_fee_amount": "0", "category_led_campaign_fee_tax_amount": "0", "brand_amplification_program_commission": "0", "brand_amplification_program_fee_tax": "0", "brand_campaign_fee": "0", "brand_campaign_fee_tax": "0", "failed_delivery_shipping_fee": "0", "buyer_fault_return_shipping_fee": "0", "insurance_fee": "0", "gmv_max_coupon_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" }, "tax": { "vat_amount": "0", "import_vat_amount": "0", "customs_duty_amount": "0", "customs_clearance_amount": "0", "sst_amount": "0", "gst_amount": "0", "iva_amount": "0", "isr_amount": "0", "anti_dumping_duty_amount": "20", "local_vat_amount": "10", "pit_amount": "10", "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", "article_22_income_tax_withheld": "0" } } } ], "total_count": 2 }, "message": "Success", "request_id": "202203070749000101890810281E8C70B7"}