淘宝双12满返红包－TOP接口变更升级说明（11-20更新）
发布于: 2015-12-18 11:53:24
尊敬的开发者：
（本次更新taobao.trade.fullinfo.get 变更内容：当交易订单为满返红包订单时，接口响应参数trade中会带有paidCouponFee字段，paidCouponFee字段的值表示满返红包的金额。如果交易订单为非满返红包订单时参数trade中没有paidCouponFee字段）
您好，淘宝双12会新增满返红包，开放平台将于10月31日开始升级API。
受影响API名称：
请提前做好准备，给您造成不便，敬请谅解。
如有问题请反馈到支持中心，感谢。
具体介绍如下：
1、双12满返红包项目介绍
满返红包是指消费者在指定店铺（参加满返活动卖家）实付金额满一定金额，由卖家让利返回给消费者，可在淘宝全场抵扣使用的现金等价物。
满返红包发放方式：买家下单付款后，其中满返红包的资金先从支付宝担保账户划到卖家账户，然后从卖家账户划到淘宝红包账户代发给买家。
例如某卖家满返红包活动为：订单实付金额（不含运费、服务费等）每满100元返10元红包。那么当买家订单实付金额为110元（A商品44元，B商品66元）时，满返红包为10元（其中A商品子订单出资4元，B商品子订单出资6元），其中10元在买家付款成功后先划到卖家账户，然后从卖家账户划到淘宝红包账户代发给买家。
满返红包商家规则：https://bbs.taobao.com/catalog/thread/17461010-318915117.htm
2、API升级说明
API名称 | taobao.trade.fullinfo.get (获取单笔交易的详细信息)，计划10月31日前升级 | |||||
链接地址 | http://open.taobao.com/doc2/apiDetail?spm=0.0.0.0.bp3Wu3&apiId=54 | |||||
升级说明 | 响应参数trade增加paidCouponFee字段(String类型）。当交易订单为满返红包订单时，接口响应参数trade中会带有paidCouponFee字段，paidCouponFee字段的值表示满返红包的金额。如果交易订单为非满返红包订单时参数trade中没有paidCouponFee字段 | |||||
业务示例 | 订单状态说明 | 主订单payment | 主订单received_payment | 主订单available_confirm_fee | A子订单payment | B子订单payment |
订单实付110元（不含运费、服务费），其中A商品44元（40元货款＋4元红包），B商品66元（60元货款＋6元红包），满返红包10元。 | 买家已付款，确认收货之前。 | 110 | 10 | 100 | 44 | 66 |
买家申请子订单退款，确认收货之前。 | 110 | 10 | 70 | 14 | 66 | |
买家A子订单确认收货。 | 110 | 20 | 60 | 14 | 66 | |
买家B子订单确认收货。 | 110 | 80 | 0 | 14 | 66 | |
API名称 | taobao.bill.accounts.get (查询费用科目信息(限自研商家))；taobao.tae.accounts.get；计划12月13日以后升级 |
链接地址 | http://open.taobao.com/doc2/apiDetail?spm=0.0.0.0.HAK5Dk&apiId=21709; http://open.taobao.com/doc2/apiDetail?spm=0.0.0.0.8LPBYM&apiId=24512 |
升级说明 | 响应参数account_id增加满返红包科目（0091），account_name新增科目名称（满返红包） |
API名称 | taobao.bill.bills.get (查询账单明细数据(自研发商家专用))，计划12月13日以后升级;taobao.tae.bills.get,计划12月13日以后升级 | |
链接地址 | http://open.taobao.com/doc2/apiDetail?spm=0.0.0.0.KcvKOf&apiId=21713; http://open.taobao.com/doc2/apiDetail?spm=0.0.0.0.pXNGb7&apiId=24513 | |
升级说明 | 新增询满返红包科目的账单明细查询，account_id增加满返红包科目（0091），account_name新增科目名称（满返红包） | |
业务示例 | 订单状态说明 | 支付流水 |
订单实付110元（不含运费、服务费），其中A商品44元（40元货款＋4元红包），B商品66元（60元货款＋6元红包），满返红包10元。 | 买家付款110元，其中10元直接到账卖家账户，然后从卖家账户划走10元到红包账户代发给消费者。 | 10元支出流水 |
买家确认收货后（未发生退款），过期未使用的红包5元退回卖家账户。（从淘宝红包账户退给卖家账户） | 5元支付退款（10元支出的退款） | |
3、其他对账说明
退款接口如taobao.refund.get 返回的退款金额（refund_fee）包括货款的实际退款金额 和从淘宝红包账户退给买家账户的金额。
如下图refund_fee＝33元（30元+3元）。
——阿里巴巴.开放平台