当交易发生之后一段时间内,由于消费者或者商户的原因需退款,商户可通过退款接口将支付款退还给消费者,喵街将在收到退款请求并验证成功后,按退款规则将支付款按原路退到消费者账号上。 1. 交易超过可退款时间(签约时设置的可退款时间)的订单无法进行退款。 2. 只支持全额退款。
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
onsite_refund_request | OnsiteRefundRequest | 必须 | 交易退款请求 | ||
|
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | ResultDo | 交易退款响应 | |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); AlibabaMosOnsiteTradeRefundRequest req = new AlibabaMosOnsiteTradeRefundRequest(); AlibabaMosOnsiteTradeRefundRequest.OnsiteRefundRequest obj1 = new AlibabaMosOnsiteTradeRefundRequest.OnsiteRefundRequest(); obj1.setExtendParams( "{\"ADDRESS\":\"123\"}" ); obj1.setOperatorId( "12345678" ); obj1.setOutRequestNo( "HZ01RF001" ); obj1.setRefundAmount(8888L); obj1.setRefundReason( "正常退款" ); obj1.setMjShopId( "hzoa" ); obj1.setStoreId( "12345678" ); obj1.setStoreIdType( "miaojie" ); obj1.setTerminalId( "NJ_T_001" ); obj1.setOrderNo( "222222" ); obj1.setAppId( "2018050860091003" ); obj1.setRefundSource( "4" ); req.setOnsiteRefundRequest(obj1); AlibabaMosOnsiteTradeRefundResponse rsp = client.execute(req, sessionKey); System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | < alibaba_mos_onsite_trade_refund_response > < result > < data > < trade_no >2015120100222</ trade_no > < out_trade_no >10001</ out_trade_no > < out_request_no >10001</ out_request_no > < refund_status >SUCCESS</ refund_status > < buyer_alipay_id >2088101117955611</ buyer_alipay_id > < refund_amount >10000</ refund_amount > < fund_bill_list > < fund_bill_do > < amount >10000</ amount > < extend_params >[{"abc":"123"}]</ extend_params > < sub_fund_channel ></ sub_fund_channel > < fund_channel >alipay</ fund_channel > </ fund_bill_do > </ fund_bill_list > < auth_code_source >MJ</ auth_code_source > < buyer_nick ></ buyer_nick > </ data > < err_code ></ err_code > < err_msg ></ err_msg > < success >true</ success > </ result > </ alibaba_mos_onsite_trade_refund_response > |
1 2 3 4 5 6 | < error_response > < code >50</ code > < msg >Remote service error</ msg > < sub_code >isv.invalid-parameter</ sub_code > < sub_msg >非法参数</ sub_msg > </ error_response > |
错误码 | 错误描述 | 解决方案 |
---|---|---|
isv.REFUND_INVALID_PARAMS | 退款操作,传入无效参数 | 请与API核对请求参数内容 |
isv.REFUND_AMOUNT_INVALID | 退款操作,传入退款金额不等于订单消费总额 | 在退款金额中输入订单总金额 |
isp.REFUND_NOT_ALLOWED_ERROR | 订单状态不允许退款 | 请检查订单的状态 |
isp.REFUND_CREATE_FAILED | 退款交易创建操作失败 | 请稍后再试 |
isp.EXISTS_REFUNDING_ORDER | 存在在途订单 | 请稍后再尝试退款 |
isv.REFUND_FAILED_STORE_NOMATCH | 退款操作失败,退款的门店与订单的门店不一致 | 请重新检查退款的订单的门店信息 |