根据退款单号查询退款信息。ISV退款订单查询只支持根据外部退款单号查询。
method:
非ISV退款订单查询：allinpay.shopoint.orderService.refundQuery.v2
ISV退款订单查询：allinpay.shopoint.orderService.isvRefundQuery
最佳实践：
退款成功的订单默认通过“5.3订单支付通知”接口推送至对接方，该接口主要用于退款失败或通知异常时的补偿查询；建议采用异步JOB轮询（间隔1分钟），当 refundStatus=1 时继续轮询，refundStatus=2/3 时终止（已获最终状态）。
需要调用查询接口的情况：
- ◆ 当商户后台、网络、服务器等出现异常，商户系统最终未接收到支付通知；
- ◆ 调用支付接口后，返回系统错误或未知交易状态情况；
- ◆ 调用统一被扫接口后，返回交易状态码trxstatus为2000时；
- ◆ 调用关单或撤销接口API之前，需确认支付状态；
version: 1.0
业务请求参数
|
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
|
reqRefundNo |
String |
否 |
64 |
外部退款单号 |
三选一,同时传则取refundNo进行查询。对于全抵扣退款订单，不支持使用trxId进行查询。推荐使用refundNo进行查询。 |
|
refundNo |
String |
否 |
40 |
数字营销退款订单号 |
|
|
trxId |
String |
否 |
30 |
退款流水号 |
业务响应参数
|
字段名 |
参数类型 |
必填 |
最大长度 |
说明 |
取值 |
||
|
code |
Integer |
是 |
4 |
返回码 |
0：表示成功； 3：表示失败，具体失败原因参见msg字段； 其他：参见4.1 公共返回码 |
||
|
msg |
String |
是 |
200 |
错误信息 |
|
||
|
data |
reqOrderNo |
String |
是 |
64 |
原交易商户订单号 |
|
|
|
refundNo |
String |
是 |
40 |
数字营销退款订单号 |
|
||
|
amount |
String |
是 |
14 |
退款订单金额 |
单位：元 |
||
|
refundStatus |
Integer |
是 |
4 |
退款状态 |
1-退款中，2-退款成功，3-退款失败 |
||
|
refundTime |
String |
是 |
19 |
退款时间 |
格式：yyyy-MM-dd HH:mm:ss |
||
|
orderCode |
String |
是 |
40 |
原交易订单号 |
|
||
|
trxId |
String |
否 |
30 |
渠道退款流水号 |
|
||
|
srcAmount |
String |
是 |
14 |
原交易金额 |
单位：元 |
||
|
errMsg |
String |
否 |
200 |
失败描述 |
|
||
|
fee |
String |
否 |
14 |
手续费 |
单位：元 |
||
|
splitRefundList |
ArrayList |
否 |
|
分账退款明细 |
|
||
|
shopId |
Integer |
否 |
11 |
店铺ID |
|
||
|
shopName |
Strinig |
否 |
50 |
店铺名称 |
|
||
|
amount |
String |
否 |
14 |
分账实退金额 |
单位：元 |
||
|
fee |
String |
否 |
14 |
退手续费 |
单位：元 |
||
请求示例
待补充
响应示例
待补充