退款状态主动查询接口

返回文档首页

功能说明: 主动查询指定交易的退款状态

接口HOST地址

取决于您原力支付服务部署所在的主机网络地址.
请注意确保防火墙设置已经允许通过该网络地址端口进行访问.
如果要修改此接口地址请通过<原力支付控制台>-<系统设置>进行设置

接口Action路径

/refundquery

请求方法: GET方法

请求参数

MerchantID 必填,最大长度12,字符串格式,大小写敏感.
商户的标识,标识了该交易订单的所属商家.
更多商户标识可以在控制台<获得产品支付入口>中查看.
RefundNo 必填,最大长度18,字符串格式,大小写敏感
要查询的退款唯一标识

应答参数

返回值 通过JSON格式返回请求结果参数:

Result --指示了此次操作结果是否成功
ResultDesc--指示了此次操作结果详细说明

以下是请求成功返回的参数:
MerchantID--返回了退款操作对应的商户标识
RefundNo --返回了退款唯一标识
TradeNo --返回了退款对应的交易唯一标识
TradeToken--返回了交易的凭据,即支付宝微信的交易流水单号
TradePayMethod --返回了这个交易所使用的支付方式.ALP支付宝,WXP微信
RefundAmount --返回了请求退款的金额
RefundReason --返回了退款的原因描述
RefundBeginTime --返回了退款的开始时间
RefundEndinTime --返回了退款的完成时间
RefundStatus --返回了退款的状态,WAIT(等待),CANCEL(取消),SUCCESS(成功),FAILED(失败)
RefundActual --返回了实际退款的金额
RefundToken --返回了退款的凭据,即支付宝微信的退款流水单号

应答状态

成功返回200,失败返回对应错误码与错误描述

备注

一般情况下,当退款完成时,系统会通过HTTP回调向您发送回调通知,这个接口用于主动的查询退款的状态,建议您在发起退款后,每隔10秒钟调用此接口来主动获取退款的状态,以便有所处理