Submit Strikethrough Price

POST

/product/202609/products/{product_id}/strikethrough_price/submit

Submit external pricing information for a product’s SKUs so that TikTok Shop can verify the product’s list price for use as a strikethrough price. If the submitted information is approved, the verified list price may be displayed as the strikethrough price when a discount applies.

Submitted pricing information expires 90 days after submission and must be resubmitted to continue supporting strikethrough price display.

Authorizations

• accessToken

Parameters

Path Parameters

product_id

required

string

The product ID in TikTok Shop.

Query Parameters

shop_cipher

required

string

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

Request Body^required

Media typeapplication/json

object

external_product_id

required

An external product identifier used on an external ecommerce platform. This value must match the external_product_id used when the product was created.

string

skus

required

A list of SKUs whose external pricing information is submitted for verification. All SKU IDs must belong to the product identified by product_id.

Array<object>

object

external_retail_price

required

The SKU retail price on the external ecommerce platform.

object

amount

required

The retail price amount. The valid range is 0.01 to 7600.

string

currency

required

The ISO 4217 currency code. The supported value is USD.

string

external_sku_id

required

An external SKU identifier used on an external ecommerce platform. This value must match the external_sku_id used when the SKU was created.

string

external_transaction_price

required

The highest actual transaction price recorded for the SKU on the external ecommerce platform during the past 90 days.

object

amount

required

The transaction price amount. The valid range is 0.01 to 7600, and the value must be equal to or greater than the list price specified when the product was created or edited.

string

currency

required

The ISO 4217 currency code. The supported value is USD.

string

image

A reference to a previously uploaded image resource that proves the highest transaction price, such as an order or invoice screenshot. Mask all customer information before uploading the image.

object

uri

required

The URI of the image. Obtain this URI by uploading the images through the Upload Product Image API with use_case=CERTIFICATION_IMAGE.

string

transaction_time

required

The RFC 3339 time when the highest transaction price was recorded. The time must include a timezone and be within the 90 days before the request.

string format: date-time

id

required

The SKU ID generated by TikTok Shop.

string

Example

{
  "external_product_id": "000059296971220002",
  "skus": [
    {
      "external_retail_price": {
        "amount": "10.00",
        "currency": "USD"
      },
      "external_sku_id": "0000592969712207012",
      "external_transaction_price": {
        "amount": "12.00",
        "currency": "USD",
        "image": {
          "uri": "tos-maliva-i-o3syd03w52-us/c668cdf70b7f483c94dbe"
        },
        "transaction_time": "2026-09-15T08:30:00Z"
      },
      "id": "1729592969712207111"
    }
  ]
}

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

errors

Item-level failures for SKUs that could not be submitted. The array is empty when every requested SKU is accepted for verification.

Array<object>

object

code

required

The stable business failure code for this SKU.

integer format: int64

detail

required

Information that identifies the failed SKU.

object

sku_id

required

The TikTok Shop SKU ID for which submission failed.

string

message

required

A human-readable description of the failure and the action needed to correct it.

string

Example

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