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

[Important] CrossBorder SIP A shop order在GetEscrowDetails和GetOrderDetails接口的返参调整

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/changelogtopic/developertopic/uncategorized

资料正文

§1 [Important] CrossBorder SIP A shop order在GetEscrowDetails和GetOrderDetails接口的返参调整

尊敬的开发者:

我们将对CrossBorder(CB) SIP A shop订单在shopee.orders.GetEscrowDetails接口和shopee.orders.GetOrderDetails接口的返回参数进行调整,具体改动如下:

对于CB SIP A shop订单, shopee.orders.GetEscrowDetails接口:

  1. 返参中的total_amount改为返回为0,开发者仍然可以取escrow_amount获取该笔订单收入

  2. 返参中的字段seller_transaction_fee和credit_card_transaction_fee的值(这两个字段的返回值是一样的,都代表SIP业务中的transaction fee)改为由service_fee字段返回,这两个字段返回为0

对于CB SIP A shop订单, shopee.orders.GetOrderDetails接口:

  1. 返参中的total_amount改为返回为0,开发者可以取escrow_amount获取该笔订单收入

  2. 返参中的currency字段改为P shop的货币单位

  3. 返参中的escrow_amount字段改为P shop货币单位对应的金额值(与GetEscrowDetails接口返参保持一致)

  4. 返参中的estimate_shipping_fee和actual_shipping_fee改为返回0

  5. variation_original_price变为P shop货币对应金额值,对应该订单商品维度的SIP结算价

  6. Variation_discounted_price字段改为返回0

另外,shopee.payment.GetPayoutDetail接口和shopee.orders.MyIncome接口权限将开放给CB SIP A shop

影响接口:

shopee.orders.GetEscrowDetails

shopee.orders.GetOrderDetails

shopee.payment.GetPayoutDetail

shopee.orders.MyIncome

上线日期:2021/05/20

Dear Developer

We will make some changes to the response data of shopee.orders.GetEscrowDetails API and shopee.orders.GetOrderDetails API in regard of the CrossBorder(CB) SIP A shop order. The details of these changes are:

For CB SIP A shop order, shopee.orders.GetEscrowDetails API:

  1. Total_amount will be returned as zero. The escrow_amount can be used as the income of this order

  2. Both seller_transaction_fee and credit_card_transaction_fee will be returned as zero (both of them stand for the SIP transaction fee). And the response data - service_fee will return the SIP transaction_fee of this order.

For CB SIP A shop order, shopee.orders.GetOrderDetails API:

  1. Total_amount will be returned as zero. The escrow_amount can be used as the income of this order

  2. Response data - currency will return the currency of SIP P shop

  3. Response data - escrow_amount will return the value in P shop currency (keep consistent with GetEscrowDetails API)

  4. Response data - estimate_shipping_fee and actual_shipping_fee will be returned as zero

  5. Response data - variation_original_price will return the value in P shop currency. This value stands for the SIP item price.

  6. Variation_discounted_price will be returned as zero

Additionally, shopee.payment.GetPayoutDetail API and shopee.orders.MyIncome API will be available for the CB SIP A shop

Affected APIs:

shopee.orders.GetEscrowDetails

shopee.orders.GetOrderDetails

shopee.payment.GetPayoutDetail

shopee.orders.MyIncome

Live date: 2021/05/20

#