Tiktok沙箱环境文档

官网的无法翻译 下载了一份翻译一下

TikTok Shop Open Platform Sandbox User Guide

1. Brief Introduction to Sandbox
   The sandbox is a parallel environment with the production environment, which enables you, the developer, to test your app developed with the TikTok Shop Open API in a simulated environment. With the sandbox environment, you can create the test products and test orders on your own without impacting any of your data in your production environment.
   Before you publish your app to the live environment (production environment), it’s recommended that you complete end to end testing. Ensuring that your app’s functionality in the sandbox operates as expected and without error.

2. Sandbox supported scenario
   TikTok will be supporting the below key eCommerce scenarios over the TikTok Shop Open API
   What can you do with the TikTok Shop Sandbox?
   ￮Authorise your sandbox testing shop
   ￮Creating/Updating/Deactivating & Deleting products
   ￮Creating testing orders (Individually / In batch)
   ￮Get order list
   ￮Change the order status, including arranging shipment for orders which are in “Awaiting Shipment” status, update to delivered or completed
   ￮Print shipping label for orders
   ￮Testing the order cancellation scenario
   Unsupported features list in TTS sandbox environment:
   ￮Global Product related functions
   ￮Order settlements are not supported
   ￮Order split/combine function
   ￮COD order is not supported
   ￮Return and refund

3. Precondition for using Sandbox
   ￮A valid TikTok Shop Open Platform Developer account which has been verified
   ￮You have created an app in the developer console, even if this app has been deleted
   Before using the sandbox, you need to have a TikTok Shop Open Platform Developer account and the identification has been verified successfully. Please refer to our developer guide. After the verification, you can create a new app in the developing status.

4. General Steps for using Sandbox
   Step 1: Create sandbox shops
   For now, there are three types of sandbox shop which are available for the developers - Indonesia Market (Local seller), UK Market (CrossBoarder seller / Local seller). You can create the test shop under the sandbox shop tab in the open platform console.

If you want to test webhook, you can add the testing webhook url on the app details page

Step 2: Log into the sandbox shop

Click the Sandbox Seller Center Link and then use the sandbox shop credentials to login

Step 3: Create sandbox testing products

For UK local seller type, you will have to create a shipping template first before you add any new products

Click the “Add new product” button, you will be directed to the sandbox seller center product creation page. Following the required info, create and publish the products.

Please note that in the sandbox environment, the brand authorization is not supported. Unauthorized brands won’t block the product creation process.

After the creation, you will find this testing product under the “Manage Products” tab in the sandbox seller center

Step 4: Create sandbox testing orders
Click the “Create order” button and then select the testing products and it’s quantity, then click the “Request” button. You will find these testing orders in “Unpaid” status under the “Manage Orders” tab. Please note that only the product in stock will appear in the dropdown list of the creating testing order page.

Please note that the maximum SKU quantity of an order is 3 and the quantity of order in one operation is 20. And for UK market, the payment for a single order should be less than 135 GBP.

Step 5: Change the unpaid orders to “awaiting_shipment” status
Click the “Change order status” button, copy the ID of orders and then put them in the Sandbox order IDs box and then select the order status to “Awaiting shipment” and then click the “Request” button

Please note that the maximum number of orders in one batch is 50, which means you can change the order status for up to 50 orders in one batch.

Step 6: Arrange the shipment for testing orders
You can arrange the shipment for the testing order individually under the “Manage Orders” tab or you can arrange shipment for testing order in batch under “Batch Shipping” tab

Step 7: Change the testing order status
For testing orders in the Platform logistics mode, after the “Arrange Shipment”, the order status will be updated to “Awaiting_collection”, for this type of order, you can change the order status to “Delivered” or “Completed” by clicking the “change order status” button.
For testing orders in the “send_by_seller” mode, after the “Arrange Shipment”, the order status will be updated to “In Transit”. You can also change the order status to “Delivered” or “Completed” by clicking the “change order status” button.

Step 8: Testing the order cancellation
Please note that only the orders in “unpaid” or “Awaiting_shipment” status can be cancelled by buyer or seller. So, for any testing orders in “unpaid” or “Awaiting_shipment” status, you can click the “Reverse Request” button under “Buyer Reverse Action” tab.

For the cancellation request for orders in awaiting shipment status, you need to accept or reject the cancellation in the sandbox seller center.

5. API call in Sandbox
   The general call method is similar to the production environment. Please refer to the
   https://developers.tiktok-shops.com/documents/document/234120
   But the url is different:
   For authorization url, please use the auth-sandbox.tiktok-shops.com as the domain for authorization in sandbox
   the example of authorization link in sandbox environment would be:
   Plaintext
   https://auth-sandbox.tiktok-shops.com/oauth/authorize?app_key=123abc&state=123
   For the API call, please use the following as the endpoint for APIs in sandbox environment
   Plaintext
   https://open-api-sandbox.tiktokglobalshop.com