退款查询接口

功能概述

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

接口地址

https://apis.5upay.com/icc/refundQuery

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 M
requestId 退款请求号 varchar(50) 商户自定义退款请求号,不能重复 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程。 M

参数示例

{ "merchantId": "888", "requestId": "12345", "hmac": " af291df5d288690d2b7d7bcff7dc5a74447ce1502c1edcc9293051bb6a517d68 6fbb31de72bfd14938d474fa6dd0afb82a2c222a6a345e41683d456a142e3376 c5c8f07dc5bc92dd5b09af316fa478a003189ed4d4c956d33162de11a8aec8ab 6abcf66b19833302780cffaa25c7e40bb9b2ccc59adc44e3fcb4632bce5d9cf9" }

响应参数列表

注意:当响应处理正常即 status 参数值为 SUCCESS 的情况下,报文才包括商户编号、订单编号等信息。

参数名称 参数中文名称 参数说明
status 响应状态 响应正常 SUCCESS
响应异常 ERROR
merchantId 商户编号 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。
orderRequestId 订单号 同请求参数
requestId 退款请求号 同请求参数
refundId 退款流水 首信易退款流水号
bankNumber 退款银行订单号 退款银行订单号
refundStatus 退款状态 初始化 INIT
处理中 PROCESSING
成功 SUCCESS
失败 FAILED
amount 退款金额 商户提交的退款金额
currency 退款币种 CNY 为人民币,USD 为美元,EUR 为欧元,GBP 为英镑,JPY 为日元,KRW 为韩元, RUB 为卢布,CHF 为瑞士法郎,HKD 为港币,SGD 为新加坡元,MOP 为澳门元,CAD 为加元,NZD 为新西兰元,TWD 为新台币,AUD 为澳大利亚元
refundSubmissionTime 退款提交时间 格式:yyyy-MM-dd HH:mm:ss
refundCompleteTime 退款完成时间 格式:yyyy-MM-dd HH:mm:ss
remark 备注 同请求参数
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

参数示例

{ "status": "SUCCESS", "merchantId": "888", " orderRequestId ": "20190813-888-12345", "requestId": "12345", "bankNumber": "1234567", "refundId": "34565", "amount": "1.00", "currency": "CNY", "refundSubmissionTime": "2019-08-13 21:30:02", "refundCompleteTime": "2019-08-13 21:30:05", "remark": "test", "hmac": " af291df5d288690d2b7d7bcff7dc5a74447ce1502c1edcc9293051bb6a517d68 6fbb31de72bfd14938d474fa6dd0afb82a2c222a6a345e41683d456a142e3376 c5c8f07dc5bc92dd5b09af316fa478a003189ed4d4c956d33162de11a8aec8ab 6abcf66b19833302780cffaa25c7e40bb9b2ccc59adc44e3fcb4632bce5d9cf9" }