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

Significant OpenAPI Updates

Shopee 官方资料 · Shopee Open Platform 变更通知(Announcements) · 适合开发者

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

来自 Shopee 官方资料快照 ·

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

资料正文

§1 Significant OpenAPI Updates

尊敬的开发者,

请留意以下变动:

1.接口shopee.orders.GetOrderDetails以及v2.order.get_order_detail中payment_method的返回值將變為與seller center保持統一,部分payment_method將返回成Online Payment。如果您對該兩個接口的payment_method值有處理,請及時關註並做對應調整。

上線時間:2021.07.15

影響接口:

Open API 1.0:

shopee.orders.GetOrderDetails

Open API 2.0:

v2.order.get_order_detail

  1. 對于部分在shopee mart售賣的FBS shop的場景需要進行調賬,將Shopee mart上售賣的營業額調整到FBS shop的店鋪上。shopee mart 店鋪將會扣除這一部分金額,同時FBS shop店鋪增加該部分金額。因此get_wallet_transaction_list接口對應新增2個transaction_type:1.調賬增加seller balance余額FBS_ADJUSTMENT_ADD 2.調賬減少seller balance余額FBS_ADJUSTMENT_MINUS。

上線時間:2021.07.08

影響接口:

Open API 2.0:

v2.payment.get_wallet_transaction_list

3.MY地区新上线fast escrow功能,支持Fast escrow放款和扣款进入seller wallet并支持在v2.payment.get_wallet_transaction_list接口记录Fast escrow交易的流水。因此,新增3种transaction_type的返回值:1.fast escrow放款为FAST_ESCROW_FACTOR_ADVANCE 2.fast escrow扣款为FAST_ESCROW_FACTOR_DEDUCT 3.扣除待支付金额后的放款FAST_ESCROW_FACTOR_REMAINING_DUE。

上線時間:已上線

影響接口:

Open API 2.0:

v2.payment.get_wallet_transaction_list

  1. 因系统数据迁移,对于2020年1月1日 00:00 之前的订单,从2021年7月12日开始,v1 GetOrderDetails接口以及v2 get_order_detail接口将promotion_type以及promotion_id两个字段的值返回为空。

上線時間:2021.7.12

影響接口:

Open API 1.0: shopee.orders.GetOrderDetails

Open API 2.0: v2.order.get_order_detail

Dear Developer,

Please find below updates:

1.API shopee.orders.GetOrderDetails and v2.order.get_order_detail’s payment_method’s value will be changed to be same with what it’s in seller center, some of the value will be returned as Online Payment.If you deal with these 2 apis’payment_method value,please pay attention and have an adjustment.

Effective Date on Live: 2021.07.15

Related APIs:

Open API 1.0:

shopee.orders.GetOrderDetails

Open API 2.0:

v2.order.get_order_detail

  1. For the situation that some of FBS shop selling products in the shopee mart, we need to make an adjustment for transaction.We will adjust the amount of selling in Shopee mart to FBS shop. In that way,shopee mart will reduce this part of amount and FBS shop will add that part.Consequently get_wallet_transaction_list api will add 2 transaction_type:1.adding adjustment of seller balance with FBS_ADJUSTMENT_ADD 2.reducing adjustment of seller balance with FBS_ADJUSTMENT_MINUS.

Effective Date on Live: 2021.07.08

Related APIs:

Open API 2.0:

v2.payment.get_wallet_transaction_list

3.MY region add the fast escrow function to support Fast escrow advance and reduction of seller wallet and be tracked in v2.payment.get_wallet_transaction_list about them.So there will be 3 new transaction_type’s value:

1.fast escrow advance withFAST_ESCROW_FACTOR_ADVANCE

2.fast escrow reduction withFAST_ESCROW_FACTOR_DEDUCT

3.Remaining Disbursement withFAST_ESCROW_FACTOR_REMAINING_DUE。

Effective Date on Live:lived

Related APIs:

Open API 2.0:

v2.payment.get_wallet_transaction_list

  1. Due to system data migration, for orders created before 00:00 on January 1, 2020, the v1 getOrderDetails API and the v2 get_order_detail API will return the values of the promotion_type and promotion_id fields as null starting from July 12, 2021.

Effective Date on Live: 2021.7.12

Related APIs:

Open API 1.0: shopee.orders.GetOrderDetails

Open API 2.0: v2.order.get_order_detail

#