来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 US & UK Markets: Exchange Orders
US & UK Markets: Exchange Orders
Effective date: July 8, 2026
§2 What's changing
What's changing
TikTok buyers will have the ability to perform an exchange, which is initiated through their return journey within the TikTok application. This allows sellers to save GMV, rather than just giving a refund for a returned item. When a buyer submits an exchange, there are new API fields within the Returns & Orders API that identify an exchange is required.
§3 Impact
This is a backward-compatible change and will not require a new API version. Existing integrations will continue to work without any modification. However, in order for a seller's system to properly identify that a new return_id and outbound order_id were initiated due to an exchange, the seller must leverage specific parameters within the APIs.
| Impacted Markets | * United States (US) * United Kingdom (UK) |
|---|---|
| Returns APIs | Parameter Update |
| --- | --- |
| Search Returns API Search Aftersales Request API Search Return Merchandise Authorization API Webhook Topic: Return Status Change | 1. Added the following enumeration to the return_typefield: * EXCHANGE 2. Added the following enumerations to the return_status field: * EXCHANGE_REQUEST_PENDING * EXCHANGE_REQUEST_REFUND_SUCCESS * EXCHANGE_REQUEST_CANCEL * EXCHANGE_REQUEST_COMPLETE |
| Get Decision Eligibility API | 1. Added the following enumeration to the check_decisions and decision fields: * ISSUE_EXCHANGE_REFUND |
| Orders API Endpoints | Parameter Update |
|---|---|
| Get Order Details API Get Order List API | 1. is_exchange_order : When true, this is an exchange order that the seller must fulfill. 2. exchange_source_order_id: If the order is an exchange order, this field returns the original order's order ID, from which the exchange order was generated. Surfaced only if is_exchange_order= true Notes: When the buyer has shipped/dropped-off the return with the logistics carrier, that signal from the carrier integration with TikTok will confirm the package is in transit, and TikTok will automatically create the new exchange order. This new exchange order will also have a $0.00 order value, because the payment/GMV was previously captured within the original order_id**, and there are no financial transactions required, as TikTok only currently allows exchanges for items with the same exact dollar value. ` |
§4 Exchange workflow
Image
- When a buyer initiates an exchange, they will select which SKU they no longer want, and then select which SKU they want to receive for the exchange.
- Once the exchange is submitted, TikTok Shop will create a new
return_idassociated with the buyer's request and the parameter forreturn_type=EXCHANGE - This
return_iddata is expected to sync from TikTok Shop to the seller's OMS and eventually WMS, so that sellers warehouse operations can expect the receiving of the return package for efficient processing. - TikTok will provide the buyer with a return shipping label (or QR code for carrier drop-off)
- The buyer will ship the return (or drop-off) with the specific carrier they selected during the return check-out
- This carrier shipped/dropped-off signal is synced to TikTok, confirming the buyer has performed their action to return the item
- Upon receiving the carrier signal, TikTok will automatically create a new outbound order for SKU-B. Within the Get Order Details API & Get Order Lists API, there are two parameters that identify the exchange scenario:
is_exchange_order: Booleanexchange_source_order_id: Original order's order ID, from which the exchange order was generated. Returned only ifis_exchange_order=true.- The seller's warehouse is expected to fulfill the order with the exchange item once they receive the order data for this exchange.
§5 FAQ
Question 1: TikTok automatically creates the exchange outbound order as soon as the buyer ships the return package. What happens if I receive the return package, and my warehouse inspects the item(s) to find them either damaged or missing? What processes do I have to dispute with the buyer and TikTok? Answer: As a seller, you can submit an arbitration process to dispute the damaged/missing items you were expecting to receive for this exchange.
Question 2: Is this a breaking change? Answer: No. This is an additive response field. Existing integrations will continue to work but you will need to map the new enumerations to ensure your data is reconciled accurately for these events.
Question 3: Does my app need a new authorization scope? Answer: Apps that already call Returns & Order scopes do not need new authorization.