退款查询

功能概述

商户通过退款订单查询接口查询首信易支付平台的订单退款交易明细。商户通过主动查询订单获知订单退款信息。

注:查询接口有每分钟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": "890000593", "requestId": "1527756058867", "hmac": null }

退款查询同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
partnerId 服务商Id 同请求参数
serialNumber 交易流水号 首信易交易流水号
status 状态 INIT 初始状态
SUCCESS 成功
FAILED 失败
ERROR 错误(此状态的返回参数见异常情况说明)
amount 退款金额 单位:分,1元=100分
completeDateTime 退款完成时间 退款完成时间
currency 退款币种 默认人民币CNY
errorMessage 错误信息 退款失败返回此项
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "amount": "1", "serialNumber": "8a0be93c633eec9c0163b55bb2d42d73", "merchantId": "890000593", "requestId": "1527756058867", "hmac": "d9c980e5967cc81ccc6478392c7dfabc", "currency": "CNY", "status": "SUCCESS" }