Skip to main content

(64) Aftersales Request Status Update

1. Trigger scenario

The Aftersales Request Status Update webhook is triggered in two scenarios:

Buyer submits a return request in their TikTok user app.

A seller makes a decision on whether to approve or reject the request.

Note: This is considered the first-review stage of the return journey. If the Afterales request is approved, it will enter the second-review stage, which is waiting for the seller to make a decision to approve or reject the returned items.

2. Data business parameters

PropertiesTypeExampleDescription
shop_idString7494049642642441621TikTok Shop identifier associated with the event.
timestampInt1732526400The time when this webhook was triggered, represented by Unix timestamp.
tts_notification_idString7327112393057371910Unique notification identifier for deduplication and tracing.
typeInt64Numeric webhook event type.
dataObject
└ aftersales_request_idString576486316948490001Unique identifier of the aftersales request.
└ return_roleStringBUYERRole that initiated the return flow. Possible enumerations: * BUYER * SELLER
└ aftersales_request_statusStringPENDING_REQUEST_REVIEWCurrent aftersales request status. Possible enumerations: * PENDING_REQUEST_REVIEW * REQUEST_REVIEW_COMPLETED
└ aftersales_request_create_timeInt1627587600Creation time of the aftersales request in Unix seconds.
└ aftersales_request_update_timeInt1644412885Last update time of the aftersales request in Unix seconds.

Event example

JSONWord Wrap

{
"type": 64,
"tts_notification_id": "1111111111",
"shop_id": "1234567890",
"timestamp": 1644412885,
"data": {
"aftersales_request_id": "576486316948490001",
"return_role": "BUYER",
"aftersales_request_status": "PENDING_REQUEST_REVIEW",
"aftersales_request_create_time": 1627587600,
"aftersales_request_update_time": 1644412885
}
}