文档中心 > 接入指南

天猫退款退货业务接入说明

更新时间：2019/12/05 访问次数：290702

一、说明
二、调用流程
三、退款状态变化
四、 FAQ
五、涉及API

一、说明

本文档面向对象为接入退款退货API开发天猫商家退款退货管理功能的第三方开发者（下文简称：isv）或自主开发的商家。

本文档将涵盖API调用场景及注意事项，天猫与集市的退款退货API将统一为一大套接口对外开放；API权限通过证书中心进行申请，处理时间一般为5个工作日以内。

对于原有已经接入tmall.eai.*接口进行天猫退款退货处理的，在处理具体退款单时，务必先重新同步一次退款数据。

二、调用流程

三、退款状态变化

退款单的状态可以在Refund数据结构中的Status获取，会根据退款操作的变化而变化。

关于退款单状态的变化情况请参考上文天猫退款退货流程，以下列表仅做描述，现有的退款单状态：

API	描述	说明
WAIT_SELLER_AGREE	买家已经申请退款，等待卖家同意	买家提交退款申请时的状态
WAIT_BUYER_RETURN_GOODS	卖家已经同意退款，等待买家退货	退款申请包含退货时，卖家同意退货（后台或者taobao.rp.returngoods.agree）后的状态
WAIT_SELLER_CONFIRM_GOODS	买家已经退货，等待卖家确认收货	退款申请包含退货，买家上传退货物流信息后的状态
SELLER_REFUSE_BUYER	卖家拒绝退款	卖家拒绝退货或者拒绝退款时
SUCCESS	退款成功	卖家批量同意退款操作后的状态
CLOSED	退款关闭	退款申请超时或者未发货的订单申请退款时卖家强制发货后的状态

四、 FAQ

1. 批量同意退款（taobao.rp.refunds.agree）操作说明

taobao.rp.refunds.agree接口仅允许子账号授权调用,并且集市支持批量(20笔以内，总金额6000以内)，天猫支持30笔以内，总金额10000以内。该接口分两个阶段，第一次不带Code参数，系统会发送验证码到当前授权所代表的子账号用户注册的手机上，第二次带Code参数（参数内容为验证码），执行同意退款打款操作，调用成功，则直接将支付宝打款给买家。

当前调用 API所用的子账号必须在子账号后台授权退款操作的权限，并设定具体的操作限额。

入参refund_infos说明

对于集市，包含信息如下：RefundId（退款单ID）、Fee（退款金额）、Version（通过taobao.refund.get接口获取refund_version）

对于天猫，包含的数据有退款ID|其对应的金额|对应版本号列表|退款阶段（onsale\aftersale），其中金额以分为单位，ID与金额以“|”符号分隔，多笔订单以“,”分隔

格式：

示例：

192242532288979|6000|12312|onsale,192242532298979|6000|32112|onsale

判断是否退款成功

success为true时，不一定全部成功，ISV需要取到results后逐个判断是否成功

2. 如何知道是否有退货？

通过Refund. has_good_return判断，true为既退款又退货，false仅退款

3. 如何获取退款单的refund_phase和refund_version

可以通过查询接口从Refund中获取

4. 买家修改退款申请后卖家操作退款单有什么影响

买家修改退款申请后，退款的refund_version会变化，退款操作时会校验refund_version,在操作中可以通过taobao.refund.get接口查询具体退款单的Refund信息。

5. 天猫暂时不支持退款留言的操作；

6. 目前不支持同意退款接口只调用一次即完成退款操作，由于接口调用会直接打款至支付宝，基于安全必须通过获取短信的方式完成退款。

7. 目前仅对同意退款操作要求仅允许子账号授权操作退款，即使用子账号授权获取到的SessionKey或者AccessToken调用taobao.rp.refunds.agree。如何使用子账号授权参考：

//open.taobao.com/doc/detail.htm?spm=a219a.7386797.0.0.dXrNao&id=101141

特别需要注意，需要保证该子账号拥有客户服务-售中售后管理-同意退款（集市需要交易管理-子账号售中退款-同意子账号退款）的权限点。

8. 沙箱不支持同意退款的调试

9. 同意退款接口返回的error_code列表有：

编号	含义
10000	发送二次验证短信成功
10001	发送二次验证短信失败
10002	二次验证码前5分钟内已发出
10003	验证短信码失败
10004	短信验证码超时（15分钟）
10005	没有输入短信验证码
10006	请先获取验证码
20000	申请退款笔数超过限制
20001	申请退款金额超过限制
30000	退款编号不合法
30001	退款不存在
30002	天猫订单
40000	操作成功
40001	操作失败
40002	部分操作失败
40003	操作失败系统异常
50000	非子帐号
60000	退款单版本已经发生变化
60001	申请金额与其实不合
99999	其它异常

五、涉及API

API文档链接：

//open.taobao.com/doc/api_cat_detail.htm?scope_id=11527&category_id=102

API	功能描述
taobao.user.seller.get	查询商家信息
taobao.refunds.receive.get	查询退款列表
taobao.refund.get	查询单笔退款
taobao.rp.returngoods.refuse	拒绝退货
taobao.rp.returngoods.agree	同意退货
taobao.rp.returngoods.refill	天猫商家回填退款物流单号
taobao.rp.refund.review	退款单标记
taobao.refund.refuse	拒绝退款
taobao.rp.refunds.agree	批量同意退款

FAQ

关于此文档暂时还没有FAQ

有用(14) 我要提问

接入指南

天猫退款退货业务接入说明

一、 说明

二、 调用流程

三、 退款状态变化

四、 FAQ

五、 涉及API

FAQ

一、说明

二、调用流程

三、退款状态变化

五、涉及API