Development Shop Manual Order Status Update Guide (Full Account)

Document Overview

This guide applies to merchants, testers, and developers working in the Full Function Account development shop environment. It explains how to manually simulate order status progression for test orders placed through the TikTok App, without relying on real fulfillment operations such as warehousing or logistics.

1. Feature Overview

In the Development Shop environment, merchants usually cannot rely on real fulfillment events to drive order status changes. The manual order status update capability allows testers to trigger status progression manually in Partner Center for test orders created from the TikTok App. It covers both the forward flow (order placement → pending shipment → in transit → delivered) and the reverse flow (order cancellation / refund), so teams can validate business logic and front-end status display end to end in the sandbox.

Dimension	Description
Applicable environment	Development Shop (Full Function Account Development Shop)
Supported regions	US / EU / SEA
Supported flows	Forward flow and reverse flow
Entry point	Development Shop order management page in Partner Center
Target users	Merchant testers, developer debugging engineers, and operation reviewers

2. Prerequisites

2.1 Environment requirements

• Full Function Account development shop environment
• The buyer account used to log in to TikTok App is already linked to the Development Shop

2.2 Test product preparation

Before placing an order in TikTok App, make sure a product has already been successfully published in the development shop.

3. Workflow Overview

The following diagram shows the full path for manually driving order status changes in the sandbox after an order is placed in TikTok App, including both forward and reverse flows.

4. Detailed Steps

4.1 Step 1: Place an order in TikTok App and confirm the order can be found in Partner Center

First, place an order through the buyer account in TikTok App, then confirm that the order has been synced to the development shop backend.

1. Use the buyer account to open the product detail page in TikTok App.
2. Complete the full process: select SKU, add to cart, place the order, and finish payment.
3. Go to the development shop backend and open Order Management.
4. Search for the order ID or filter by time, then confirm the order is visible and the status is On Hold.

Acceptance criteria: The order placed in TikTok App can be found in Partner Center and the status is synced correctly, which means the TikTok App order placement path is working as expected.

4.2 Step 2: Forward flow — manually drive status progression in the backend

4.2.1 On Hold → Pending Shipment

1. Find the target order in the backend. The current status should be On Hold.
2. Open the order details page and locate the manual status push action button.
3. Select Pending Shipment and confirm the submission.
4. Open My Orders in TikTok App and verify that the order status has been updated to Pending Shipment.

Note: After the backend status is pushed manually, the TikTok App status is usually synced within a few seconds. If the update is not visible yet, wait briefly and refresh the page.

4.2.2 Pending Shipment → Awaiting Collection → In Transit

1. Confirm that the current order status is Pending Shipment.
2. Click Ship Order in the backend and fill in simulated logistics information. The tracking number can be a test value.
3. After submission, the order status changes to Awaiting Collection / Shipped, and you can continue to push it manually to In Transit.
4. Verify that the corresponding order status in My Orders in TikTok App is updated accordingly.

4.2.3 In Transit → Delivered

1. Confirm that the current order status is In Transit.
2. Manually push the order to Delivered in the backend.
3. Verify in TikTok App that the order status is updated to Delivered. The forward flow is now complete.

Acceptance criteria: After each manual status push in the backend, the order status in TikTok App is updated accordingly, which confirms that the forward status sync path is working properly.

4.3 Step 3: Reverse flow — initiate cancellation or refund from the backend

4.3.1 Reverse flow: Cancel an order

1. Find the target order in the backend when the status is On Hold or Pending Shipment.
2. Click Cancel Order.
3. Select a cancellation reason and confirm the submission.
4. Verify in TikTok App that the order status is updated to Cancelled.

4.3.2 Reverse flow: Initiate a refund

1. Find the target order in the backend and click Initiate Refund.
2. Fill in the refund reason and refund amount, then submit the refund request.
3. In the Seller Center refund management page, locate the request and click Approve Refund.
4. After refund approval is completed, verify in TikTok App that the refund status has been updated.

Important: The refund flow requires two backend actions: submit the refund request and approve the refund as the merchant. The TikTok App status changes only after the approval step is completed.

4.4 Step 4: Reverse flow initiated in TikTok App — cancellation synced back to the backend

This test case verifies whether a cancellation initiated by the user in TikTok App is synced back to the backend correctly.

1. Use a test account to place an order in TikTok App, and confirm in the backend that the order has been created with status On Hold.
2. In My Orders in TikTok App, find the order and click Cancel Order.
3. After the cancellation is completed, switch to Seller Center.
4. Refresh the order list and confirm that the order status has been updated to Cancelled.

Acceptance criteria: After the cancellation is initiated in TikTok App, the backend order status is updated successfully, which confirms that the reverse status callback path from TikTok App is working correctly.

4.5 Step 5: Regression validation for existing online capability

After completing the TikTok App-related test cases above, also run regression testing for the existing forward and reverse flows of backend-created orders to make sure the new feature does not affect the original order operation path.

1. Use Create Order Manually in the backend to create a test order that is not placed through TikTok App.
2. Execute the full forward flow: On Hold → Pending Shipment → In Transit → Delivered.
3. Create another test order and execute the reverse flow: Cancel / Refund.
4. Confirm that all existing functions still work correctly and there are no regression issues.

5. Quick Reference: Status Transitions

Action type	Starting status	Target status	Entry point
Forward	On Hold	Pending Shipment	Backend → Order details → Manual status push
Forward	Pending Shipment	Awaiting Collection / In Transit	Backend → Ship Order
Forward	In Transit	Delivered	Backend → Manual progression
Reverse	On Hold / Pending Shipment	Cancelled	Backend → Cancel Order
Reverse	Any status	Refunding / Refunded	Backend → Initiate Refund → Approve Refund
Consumer-side reverse	On Hold	Cancelled	TikTok App → My Orders → Cancel Order

6. FAQ

Q1: I cannot find the order in the backend after placing it in TikTok App. What should I do?

• Confirm that the logged-in development shop account and the shop used in TikTok App are the same shop.
• Confirm that the correct region (US / EU / SEA) is selected. Orders are not shared across regions.
• Confirm that the payment flow in TikTok App has been fully completed, including payment confirmation. Unpaid orders will not be synced to the backend.
• Wait about 30 seconds, refresh the order list in the backend, and try again.

Q2: The TikTok App order status does not update after I manually push the status. How should I handle it?

• Wait 10 to 30 seconds and manually refresh My Orders in TikTok App.
• Check whether the backend status push was submitted successfully and whether the backend order status has changed.
• If the backend status has changed but TikTok App is not updated yet, this is likely due to delayed status delivery. Wait a little longer or ask the technical team to check the message queue.

Q3: Are the test flows for EU / SEA the same as for the US region?

Yes. The core process is exactly the same as the US flow. The only difference is that you need to use the test product deeplink and shop account for the corresponding region. Please confirm the required EU / SEA test assets with the business owner before testing.

Q4: Why does the TikTok App status not change during the refund flow?

• The refund flow requires two actions in Seller Center: submit refund request and approve refund.
• If only the refund request is submitted, the TikTok App status will not change immediately.
• Make sure the request has been found on the refund management page and Approve Refund has been clicked.

Q5: Will the sandbox manual status push capability affect production data?

Sandbox and production are fully isolated. The development shop environment is isolated from production, and all test operations will not affect real orders or real user data.

Q6: Does this feature support bulk manual status pushing?

• The current feature is designed mainly for single-order operations. If bulk verification is needed, repeat the process order by order or confirm with the engineering team whether a bulk interface is available.