商户通过退款订单查询接口查询首信易支付平台的订单退款交易明细。商户通过主动查询订单获知订单退款信息。
注:查询接口有每分钟200次的限制,超过此限制会报错。
https://apis.5upay.com/onlinePay/refundQuery
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id,可在商户后台查看 | M |
| requestId | 订单号 | varchar(50) | 退款接口传入的requestid | C |
| partnerId | 服务商id | varchar(9) | 服务商在首信易系统的唯一id,可在商户后台查看 | C |
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| requestId | 订单号 | 同请求参数 |
| partnerId | 服务商Id | 同请求参数 |
| serialNumber | 交易流水号 | 首信易交易流水号 |
| status | 状态 | INIT 初始状态 |
| SUCCESS 成功 | ||
| FAILED 失败 | ||
| ERROR 错误(此状态的返回参数见异常情况说明) | ||
| amount | 退款金额 | 单位:分,1元=100分 |
| completeDateTime | 退款完成时间 | 退款完成时间 |
| currency | 退款币种 | 默认人民币CNY |
| errorMessage | 错误信息 | 退款失败返回此项 |
| hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |