Skip to content

(21) Inbound FBT order status change

POST

This webhook is triggered when the status of an FBT inbound order changes.

Prerequisite: The Fulfilled by TikTok(FBT) Info API scope is enabled in Partner Center. For more information, refer to Access Scope.

Media typeapplication/json
object
type
required

The ID of the webhook type.

integer
Allowed value: 21
tts_notification_id

The ID of this webhook notification.

string
seller_open_id

The open_id of the seller. For more information, refer to Authorization overview.

string
timestamp

The time when this webhook is triggered. Unix timestamp.

integer format: int64
data
object
inbound_order_id

FBT inbound order ID.

string
order_status

Inbound order status. Possible enumerations:

  • TO_BE_RECEIVED
  • ARRIVE_HUB,
  • RECEIVING,
  • PARTIALLY_RECEIVED,
  • RECEIVED,
  • CANCELLED
string
Allowed values: TO_BE_RECEIVED ARRIVE_HUB RECEIVING PARTIALLY_RECEIVED RECEIVED CANCELLED
update_time

The time when the change occurred. Unix timestamp.

integer format: int64
Example
{
"type": 21,
"seller_open_id": "VIyStQAAAADCBQ40s4TzOSSOEIW-bM5O9cod3vK8OytW8m-bnBYlXw",
"tts_notification_id": "7327112393057371910",
"timestamp": 1644412885,
"data": {
"inbound_order_id": "IBR577087614418520388",
"order_status": "CANCELLED",
"update_time": 1644412845
}
}

Return HTTP 200 to acknowledge receipt.