快工助手跨境电商知识与商机助手

order_status_push

Shopee 官方资料 · Shopee Open Platform 推送机制(Push Mechanism) · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.push_mechanism
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/api_doctopic/apitopic/developertopic/order-pushtopic/push

资料正文

§1 order_status_push

Get notified immediately on all order status updates. This includes order cancellations that occur before shipping, so that you can take the necessary steps in time.

#

§2 Overview

Overview

FieldValue
Push code3
Timeout (seconds)3
Retry strategy (seconds)300, 1800, 10800
Guaranteed deliveryNo
#

§3 Push parameters

Push parameters

NameTypeRequiredSampleDescription
dataobjectMain Push message data
data.ordersnstring220810QSK8S7BXReturn by default. Shopee's unique identifier for an order.
data.statusstringPROCESSEDReturn by default. Enumerated type that defines the current status of the order.
data.completed_scenariostringNORMALTo indicate which COMPLETED status order is in.; NORMAL: The order has been completed.; RRAOC: The whole RRAOC (raise return&refund after order completed) progress has been completed.
data.update_timetimestamp1660123127Return by default. Timestamp that indicates the last time that there was a change in value of order, such as order status changed from 'Paid' to 'Completed'.
shop_idint727720655Shopee's unique identifier for a shop. Required param for most APIs.
codeint3Shopee's unique identifier for a push notification.
timestamptimestamp1660123127Timestamp that indicates the message was sent.
#

§4 Sample

Sample

{"data":{"items":[],"ordersn":"220810QSK8S7BX","status":"PROCESSED","completed_scenario":"","update_time":1660123127},"shop_id":727720655,"code":3,"timestamp":1660123127}
#

§5 Update log

Update log

DateChange
2023-08-14Shopee now support buyer to raise return& refund after order completed, for order_status_push add new field "completed_scenario" to indicate which COMPLETED status order is in.
2022-08-18New Push Mechanism
#