Chuyển tới nội dung chính

(11) Thay đổi trạng thái hủy đơn

1. Tình huống kích hoạt

Webhook thay đổi trạng thái hủy đơn được kích hoạt khi cancel_status của một đơn hàng thay đổi:

  • Một yêu cầu hủy đơn được khởi tạo: CANCELLATION_REQUEST_PENDING
  • Một yêu cầu hủy đơn được chấp nhận bởi SELLER hoặc SYSTEM: CANCELLATION_REQUEST_SUCCESS
  • Một yêu cầu hủy đơn bị đóng bởi BUYER hoặc SYSTEM: CANCELLATION_REQUEST_CANCELLED
  • Một yêu cầu hủy đơn thành công và đã hoàn tiền: CANCELLATION_REQUEST_COMPLETE

2. Tham số nghiệp vụ dữ liệu

Parameter nameSampleDescription
order_id577087614418520388Mã định danh của một đơn hàng TikTok Shop
cancellations_roleBUYERNgười khởi tạo yêu cầu hủy đơn, với các giá trị có thể có: * BUYER * SELLER * SYSTEM
cancel_statusCANCELLATION_REQUEST_PENDINGTrạng thái hủy đơn hàng, với các giá trị có thể có: * CANCELLATION_REQUEST_PENDING * CANCELLATION_REQUEST_SUCCESS * CANCELLATION_REQUEST_CANCELLED * CANCELLATION_REQUEST_COMPLETE
cancel_id4035318504086604100Mã định danh của một yêu cầu hủy đơn cụ thể
create_time1627587600Thời điểm người mua khởi tạo yêu cầu hủy đơn, được biểu diễn dưới dạng Unix timestamp (giây).

Ví dụ sự kiện

JSONWord Wrap

{
"type": 11,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": {
"order_id": "576486316948490001",
"cancellations_role": "BUYER",
"cancel_status": "CANCELLATION_REQUEST_PENDING",
"cancel_id": "4035318504086604100",
"create_time": 1627587600
}
}