Significant OpenAPI Updates

Dear Developers,

Please take note the following changes:

1. For some technical reasons, the update of the interface v2.payment.get_escrow_detail released on November 14 is postponed to go live, the specific release time will be notified, please be informed!

2. Please note that the updates mentioned below are applicable to Shopee SG CB whitelisted sellers only.

Shopee SG is launching the 5 Day Guaranteed Delivery (5DD) Programme under the new CB SLS channel. This channel will roll out to sellers on a whitelisted basis only.

Sample of response body：

v2.logistics.get_channel_list

Seller will be able to enable/disable (5DD) channel on a shop-level and item-level basis through Open API.

RelatedAPIs:

v2.logistics.get_channel_list

v2.logistics.update_channel

v2.product.add_item

v2.product.update_item

v2.product.get_item_base_info

v2.logistics.get_shipping_parameter

v2.logistics.get_tracking_number

v2.logistics.get_shipping_document_parameter

v2.order.get_order_detail

v2.logistics.get_shipping_document_data_info

Effective Date: 2023.11.27

3. Currently, after Shopee sends the push message to your callback URL, if it fails, Shopee will retry three times, if it still fails, to avoid continuously occupying resources, Shopee will discard the push message and stop further retries, which may result in your system missing some push messages.

To address this issue, we add the v2.push.get_lost_push_message API, which allows you to get the lost push messages from your APP within the last 3 days, and we also add the v2.push.confirm_consumed_lost_push_message API to confirm that your APP has successfully got and consumed the lost push messages.

Note: The v2.push.get_lost_push_message API will only return the earliest 100 lost push messages within the last 3 days that have not been confirmed as consumed. To ensure that you can get all lost push messages, please call the v2.push.confirm_consumed_lost_push_message API to confirm after getting and consuming the lost push messages.

Related APIs:

v2.push.get_lost_push_message

v2.push.confirm_consumed_push_message

Effective Date on Live:

November 16, 2023

尊敬的开发者，

请留意以下变动:

1.因一些技术原因，11月14号发布的关于接口v2.payment.get_escrow_detail的更新将推迟上线，具体上线时间将另行通知，请知悉。

2.请注意，以下更新内容仅适用于Shopee 新加坡站点跨境白名单卖家。

Shopee新加坡站点目前推出了“跨境5日承诺达”物流渠道，该物流渠道仅向符合要求的白名单卖家开放。

响应示例：

v2.logistics.get_channel_list

影响接口：

v2.logistics.get_channel_list

v2.logistics.update_channel

v2.product.add_itemv2.product.update_item

v2.product.get_item_base_info

v2.logistics.get_shipping_parameter

v2.logistics.get_tracking_number

v2.logistics.get_shipping_document_parameter

v2.order.get_order_detail

v2.logistics.get_shipping_document_data_info

生效日期: 2023.11.27

3. 目前，Shopee在向您的回调地址推送Push消息后，若推送失败，平台将会重试三次，若仍然失败，为了避免一直占用资源，平台将丢弃该条Push消息，不再继续推送，可能导致您的系统漏掉部分Push消息。

为了解决这一问题，平台新增了v2.push.get_lost_push_message接口，用于获取您的APP在过去3天内丢弃的Push消息，同时新增了v2.push.confirm_consumed_push_message接口，用于确认您的APP已经完成丢弃Push消息的获取与消费。

注意：v2.push.get_lost_push_message接口默认只返回您的APP在过去3天内丢弃且未确认消费的Push消息中最早丢弃的100条Push消息，为了保证您能获取全部的丢弃消息，请您在获取丢弃的Push消息并且完成消费后，调用v2.push.confirm_consumed_push_message接口确认已消费。

影响接口：

v2.push.get_lost_push_message

v2.push.confirm_consumed_push_message

生效日期：

2023年11月16日