Update The Blind Box Opening Results

POST

/order/202605/orders/blind_box_result/callback

After the merchant completes blind box opening in a live room, use this callback to send the opening results for an order back to the platform. The request supports two result shapes: blind_box_results contains one unboxed product per item, while blind_batch_box_results groups one or more unboxed products under an order line. If blind_batch_box_results is non-empty, the platform processes it and ignores blind_box_results. Buyers can then view the unboxing results in the order details.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

Request Body

Media typeapplication/json

object

main_order_id

The unique identifier for a TikTok Shop order.

string

blind_box_results

When using the legacy result shape, provide unboxing results for one or more blind-box line items in the specified order.

Array<object>

object

order_line_id

The TikTok Shop line item ID for the blind box in the specified order.

string

blind_result_product_id

The TikTok Shop product ID revealed by opening the blind box.

string

blind_result_sku_id

The TikTok Shop SKU ID revealed by opening the blind box.

string

blind_open_time

Unix timestamp in milliseconds indicating when the blind box was opened.

integer format: int64

blind_batch_box_results

Unboxing batch results for line items under orders.

Array<object>

object

order_line_id

The TikTok Shop line item ID of the blind box in the specified order to which this batch unboxing result belongs.

string

blind_box_order_line_list

Unboxing results for line items under orders. on batch box version

Array<object>

object

blind_result_product_id

The TikTok Shop product ID revealed for this item in the batch unboxing result.

string

blind_result_sku_id

The TikTok Shop SKU ID revealed for this item in the batch unboxing result.

string

blind_open_time

Unix timestamp in milliseconds indicating when the blind box was opened.

integer format: int64

product_type

Unboxing product type. Possible values:

• NORMAL: A normal unboxed product.
• GIFT: A gift unboxed product.

string

Allowed values: NORMAL GIFT

Example

{
  "main_order_id": "576461413038785752",
  "blind_box_results": [
    {
      "order_line_id": "577086512123755123",
      "blind_result_product_id": "1732042550463074704",
      "blind_result_sku_id": "1732042694638604688",
      "blind_open_time": 1762782183118
    }
  ],
  "blind_batch_box_results": [
    {
      "order_line_id": "577086512123755123",
      "blind_box_order_line_list": [
        {
          "blind_result_product_id": "1732042550463074704",
          "blind_result_sku_id": "1732042694638604688",
          "blind_open_time": 1762782183118,
          "product_type": "NORMAL"
        }
      ]
    }
  ]
}

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

Example

{
  "code": 0,
  "data": {},
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}