您的位置 : 文档中心 -> API信息

com.alibaba.trade:alibaba.trade.refund.OpQueryOrderRefund-1
查询退款单详情-根据退款单ID 免费

查询退款单详情,同时可以查询到退款操作列表。 该API需要像阿里巴巴申请权限才能访问。

API用户授权类型

需要授权

系统级输入参数

名称 类型 是否必须 描述
_aop_timestamp String 请求时间戳
_aop_signature String 请求签名
access_token String 用户授权令牌

应用级输入参数

名称 类型 是否必须 描述 示例值 默认值
refundId String 退款单业务主键 TQ+ID TQ11173622***991577
needTimeOutInfo boolean 需要退款单的超时信息 true
needOrderRefundOperation boolean 需要退款单伴随的所有退款操作信息 true

返回结果

名称 类型 是否必须 描述 示例值
+ result alibaba.trade.refund.OpQueryOrderRefundResult 查询结果 {}
errorCode String 错误码 500
errorMessage String 错误描述信息 退款单错误
extErrorMessage String 补充错误描述信息 退款单错误

返回结果

extInfo参数说明

  payMode     资金分流(alipay:支付宝,fundFreeze:资金平台账户冻结) 
 7d          7天无理由订单标记(1表示7天无理由订单)  

请求参数示例

  refundId :TQ865149372**61198
needTimeOutInfo :true
needOrderRefundOperation :true 

返回参数示例

  {"result":{"opOrderRefundModelDetail":{"alipayPaymentId":"2018042321001008760555342267","applyCarriage":0,"applyPayment":1,"applyReason":"颜色/图案/款式不符","applyReasonId":20021,"applySubReasonId":0,"buyerLogisticsName":"其他","buyerMemberId":"b2b-1624961198","buyerSendGoods":true,"buyerUserId":1624961198,"canRefundPayment":1,"crmModifyRefund":false,"disputeRequest":3,"disputeType":1,"extInfo":{"EXmrf":"1","ttid":"2","prepaidFailure":"QUERY_BUYER_CREDIT_LEVEL_FAIL","pay_lock":"seller","reason":"20021","apply_text_id":"null","newRefund":"rp2","bizCode":"cbu.general.refund","disputeTradeStatus":"4","lastOrder":"0","seller_agreed_refund_fee":"1","old_reason_id":"20021","sync":"0","b2b_seller_mId":"b2b-1623492085","seller_batch":"true","itemBuyAmount":"0","b2b_buyer_mId":"b2b-1624961198","ability":"1","refundPostFee":"0","seller_audit":"0","ee_trace_id":"0b802ca915244768332374685efa19","ol_tf":"1","opRole":"user","apply_init_refund_fee":"1","isVirtual":"0","logisticsCompanyId":"-1","itemPrice":"0","interceptStatus":"0","refundFrom":"2","restartForXiaoer":"1","appName":"tosp-aftersales","abnormal_dispute_status":"0","payMode":"alipay","workflowName":"cbu_return_and_refund","sgr":"1","enfunddetail":"1","sellerDoRefundNick":"alitestforisv01","bgmtc":"2018-04-23 09:48:12"},"freightBill":"12345134135435234","frozenFund":-1,"gmtApply":"20180423171116000+0800","gmtCompleted":"20180423174713000+0800","gmtCreate":"20180423171116000+0800","gmtModified":"20180423174714000+0800","goodsReceived":true,"goodsStatus":3,"id":8651493722961198,"newRefundReturn":true,"onlyRefund":false,"orderEntryCountMap":{"151267031009969811":2},"orderEntryIdList":[151267031009969811],"orderId":151267031008969811,"productName":"欧洲站2018新款宽松显瘦烫金印花字母老鹰短袖T恤打底裤套装女潮","refundCarriage":0,"refundGoods":true,"refundId":"TQ8651493722961198","refundPayment":1,"rejectReasonId":0,"rejectTimes":0,"sellerDelayDisburse":false,"sellerMemberId":"b2b-1623492085","sellerMobile":"19926555555","sellerRealName":"琳琳","sellerReceiveAddress":"山东 聊城 解决了交流交流链接连接","sellerUserId":1623492085,"status":"refundsuccess","supportNewSteppay":true,"timeOutFreeze":false,"tradeTypeStr":"50060","refundOperationList":[{"afterOperateStatus":"waitsellerreceive","beforeOperateStatus":"waitsellerreceive","closeRefundStepId":0,"crmModifyRefund":false,"discription":"卖家同意退货退款协议,退货退款成功","gmtCreate":"20180423174714000+0800","gmtModified":"20180423174714000+0800","id":50027795018,"messageStatus":3,"msgType":7,"operateRemark":"退款成功","operateTypeInt":8,"operatorLoginId":"alitestforisv01","operatorRoleId":2,"operatorUserId":1623492085,"refundId":"TQ8651493722961198"},{"afterOperateStatus":"waitbuyersend","beforeOperateStatus":"waitbuyersend","closeRefundStepId":0,"crmModifyRefund":false,"discription":"买家声明退货,等待卖家确认。|物流公司:其他|物流单号:12345134135435234|说明:asdada|","gmtCreate":"20180423174651000+0800","gmtModified":"20180423174651000+0800","id":50027571423,"messageStatus":3,"msgType":7,"operateRemark":"买家退货","operateTypeInt":10,"operatorLoginId":"alitestforisv02","operatorRoleId":1,"operatorUserId":1624961198,"refundId":"TQ8651493722961198"},{"afterOperateStatus":"waitselleragree","beforeOperateStatus":"waitselleragree","closeRefundStepId":0,"crmModifyRefund":false,"discription":"卖家确认收货地址:琳琳,19926555555,山东 聊城 解决了交流交流链接连接","gmtCreate":"20180423174544000+0800","gmtModified":"20180423174544000+0800","id":49967844797,"messageStatus":3,"msgType":7,"operateRemark":"确认收货地址","operateTypeInt":19,"operatorLoginId":"alitestforisv01","operatorRoleId":2,"operatorUserId":1623492085,"refundId":"TQ8651493722961198"},{"closeRefundStepId":0,"crmModifyRefund":false,"discription":"退款诉求:退货退款|申请原因:颜色/图案/款式不符|货品情况:已收到货|退款货品金额:0.01|退款运费金额:0.00|退款说明:asdad","gmtCreate":"20180423171116000+0800","gmtModified":"20180423171116000+0800","id":49962356896,"messageStatus":3,"msgType":7,"operateRemark":"买家申请退款协议,等待卖家确认","operateTypeInt":1,"operatorLoginId":"alitestforisv02","operatorRoleId":1,"operatorUserId":1624961198,"refundId":"TQ8651493722961198"}],"buyerLoginId":"alitestforisv02","sellerLoginId":"alitestforisv01"}}} 

错误码

错误码 错误描述 解决方案
500 {\"errorCode\":\"003\",\"errorMessage\":\"SERVICE:查询数据失败,请检查输入参数后重试。\",\"cause\":\"\"} 非授权用户的退款单
500 {\"errorCode\":\"003002\",\"errorMessage\":\"SERVICE:INVOKE_FAIL:退款数据错误,请检查退款单号,退款单号的格式一般为TD+id\",\"cause\":\"errorCode:REFUND_DATA_ERROR,errorMsg:refundId : 11043002311780591,cause:null\"} 退款单不正确
500 {\"errorCode\":\"003002\",\"errorMessage\":\"SERVICE:INVOKE_FAIL:OrderRefundService#queryOrderRefundOperationList\",\"cause\":\"errorCode:INVALID_PARAM,errorMsg:null,cause:null\"} 退款单不正确

API工具

SDK 示例