一、 說明
本文檔面向?qū)ο鬄榻尤胪丝钔素汚PI開發(fā)天貓商家退款退貨管理功能的第三方開發(fā)者（下文簡稱：isv）或自主開發(fā)的商家。
本文檔將涵蓋API調(diào)用場景及注意事項，天貓與集市的退款退貨API將統(tǒng)一為一大套接口對外開放；API權限通過證書中心進行申請，處理時間一般為5個工作日以內(nèi)。
對于原有已經(jīng)接入tmall.eai.*接口進行天貓退款退貨處理的，在處理具體退款單時，務必先重新同步一次退款數(shù)據(jù)。
問題交流群請加入：
1408358214
二、 調(diào)用流程
三、 退款狀態(tài)變化
退款單的狀態(tài)可以在Refund數(shù)據(jù)結構中的Status獲取，會根據(jù)退款操作的變化而變化。
關于退款單狀態(tài)的變化情況請參考上文天貓退款退貨流程，以下列表僅做描述，現(xiàn)有的退款單狀態(tài)：
API | 描述 | 說明 |
WAIT_SELLER_AGREE | 買家已經(jīng)申請退款，等待賣家同意 | 買家提交退款申請時的狀態(tài) |
WAIT_BUYER_RETURN_GOODS | 賣家已經(jīng)同意退款，等待買家退貨 | 退款申請包含退貨時，賣家同意退貨（后臺或者taobao.rp.returngoods.agree）后的狀態(tài) |
WAIT_SELLER_CONFIRM_GOODS | 買家已經(jīng)退貨，等待賣家確認收貨 | 退款申請包含退貨，買家上傳退貨物流信息后的狀態(tài) |
SELLER_REFUSE_BUYER | 賣家拒絕退款 | 賣家拒絕退貨或者拒絕退款時 |
SUCCESS | 退款成功 | 賣家批量同意退款操作后的狀態(tài) |
CLOSED | 退款關閉 | 退款申請超時或者未發(fā)貨的訂單申請退款時賣家強制發(fā)貨后的狀態(tài) |
四、 FAQ
1. 批量同意退款（taobao.rp.refunds.agree）操作說明
taobao.rp.refunds.agree接口僅允許子賬號授權調(diào)用,并且集市支持批量(20筆以內(nèi)，總金額6000以內(nèi))，天貓支持30筆以內(nèi)，總金額10000以內(nèi)。 該接口分兩個階段，第一次不帶Code參數(shù)，系統(tǒng)會發(fā)送驗證碼到當前授權所代表的子賬號用戶注冊的手機上，第二次帶Code參數(shù)（參數(shù)內(nèi)容為驗證碼），執(zhí)行同意退款打款操作，調(diào)用成功，則直接將支付寶打款給買家。
當前調(diào)用 API所用的子賬號必須在子賬號后臺授權退款操作的權限，并設定具體的操作限額。
入?yún)efund_infos說明
對于集市，包含信息如下：RefundId（退款單ID）、Fee（退款金額）、Version（通過Refund數(shù)據(jù)結構獲取）
對于天貓，包含的數(shù)據(jù)有退款ID|其對應的金額|對應版本號列表|退款階段（onsale\aftersale），其中金額以分為單位，ID與金額以“|”符號分隔，多筆訂單以“,”分隔
格式：
RefundId1|Fee1|Version1|Refund_phase,RefundId2|Fee2|Version2|Refund_phase ...
示例：
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. 目前不支持同意退款接口只調(diào)用一次即完成退款操作，由于接口調(diào)用會直接打款至支付寶，基于安全必須通過獲取短信的方式完成退款。
7. 目前僅對同意退款操作要求僅允許子賬號授權操作退款，即使用子賬號授權獲取到的SessionKey或者AccessToken調(diào)用taobao.rp.refunds.agree。如何使用子賬號授權參考：
//open.taobao.com/doc/detail.htm?spm=a219a.7386797.0.0.dXrNao&id=101141
特別需要注意，需要保證該子賬號擁有客戶服務-售中售后管理-同意退款（集市需要交易管理-子賬號售中退款-同意子賬號退款）的權限點。
8. 沙箱不支持同意退款的調(diào)試
9. 同意退款接口返回的error_code列表有：
編號 | 含義 |
10000 | 發(fā)送二次驗證短信成功 |
10001 | 發(fā)送二次驗證短信失敗 |
10002 | 二次驗證碼前5分鐘內(nèi)已發(fā)出 |
10003 | 驗證短信碼失敗 |
10004 | 短信驗證碼超時（15分鐘） |
10005 | 沒有輸入短信驗證碼 |
10006 | 請先獲取驗證碼 |
20000 | 申請退款筆數(shù)超過限制 |
20001 | 申請退款金額超過限制 |
30000 | 退款編號不合法 |
30001 | 退款不存在 |
30002 | 天貓訂單 |
40000 | 操作成功 |
40001 | 操作失敗 |
40002 | 部分操作失敗 |
40003 | 操作失敗 系統(tǒng)異常 |
50000 | 非子帳號 |
60000 | 退款單版本已經(jīng)發(fā)生變化 |
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
