(64) Aftersales Request Status Update

POST

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

1. Buyer submits a return request in their TikTok user app.
2. 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.

Authorizations

• webhookSignature

Request Body^required

Media typeapplication/json

object

shop_id

TikTok Shop identifier associated with the event.

string

timestamp

The time when this webhook was triggered, represented by Unix timestamp.

integer format: int64

tts_notification_id

Unique notification identifier for deduplication and tracing.

string

type

required

The ID of the webhook type.

integer

Allowed value: 64

data

object

aftersales_request_id

Unique identifier of the aftersales request.

string

return_role

Role that initiated the return flow. Possible enumerations:

• BUYER
• SELLER

string

Allowed values: BUYER SELLER

aftersales_request_status

Current aftersales request status. Possible enumerations:

• PENDING_REQUEST_REVIEW
• REQUEST_REVIEW_COMPLETED

string

Allowed values: PENDING_REQUEST_REVIEW REQUEST_REVIEW_COMPLETED

aftersales_request_create_time

Creation time of the aftersales request in Unix seconds.

integer format: int64

aftersales_request_update_time

Last update time of the aftersales request in Unix seconds.

integer format: int64

Example

{
  "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
  }
}

Responses

200

Return HTTP 200 to acknowledge receipt.