商户通过单笔订单查询接口查询首信易支付平台的订单状态,并且通过主动查询订单来获知订单信息。
https://apis.5upay.com/icc/orderQuery
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 | M |
requestId | 订单号 | varchar(50) | 该参数格式为:订单生成日期-商户编号-商户流水号。例如:20170101-888-12345。商户流水号为数字,每日内不可重复,并且不能包括除数字、英文字母和“-”外以其它字符。流水号可为一组也可以用“-”间隔成几组 | M |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程。 | M |
注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格
注:注意:当响应处理正常即 status 参数值为 SUCCESS 的情况下,报文才包括商户编号、订单编号等信息。
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
status | 响应状态 | 响应正常 SUCCESS |
响应异常 ERROR | ||
pstatus | 支付状态 | 初始化 INIT |
成功 SUCCESS | ||
失败 FAILED | ||
处理中 PROCESSING | ||
pstatusDescription | 支付状态说明 | 见平台状态码表 |
merchantId | 商户编号 | 同请求参数 |
paymentModeAlias | 支付方式名称 | 返回值为 VISA Master AE JCB |
requestId | 订单号 | 同请求参数 |
serialNumber | 交易流水号 | 首信易支付系统交易流水号 |
bankNumber | 银行订单号 | 银行订单号 |
orderCurrency | 订单币种 | CNY 为人民币,USD 为美元,EUR 为欧元,GBP 为英镑,JPY 为日元,KRW 为韩元, RUB 为卢布,CHF 为瑞士法郎,HKD 为港币,SGD 为新加坡元,MOP 为澳门元,CAD 为加元,NZD 为新西兰元,TWD 为新台币,AUD 为澳大利亚元 |
orderAmount | 订单金额 | 同请求参数 |
submissionTime | 订单提交时间 | 订单提交时间 格式:yyyy-MM-dd HH:mm:ss |
completeTime | 订单扣款时间 | 支付完成时间 格式:yyyy-MM-dd HH:mm:ss |
totalRefundCount | 退款总笔数 | 该支付订单共计退款次数 |
totalRefundAmount | 退款总金额 | 该支付订单共计退款金额 |
refundDetails | 退款详情 | 退款详情,见下表 |
totalRefuseCount | 拒付总笔数 | 该支付订单共计拒付次数 |
totalRefuseAmount | 拒付总金额 | 该支付订单共计拒付金额 |
refuseDetails | 拒付详情 | 拒付详情 ,见下表 |
remark | 备注 | 在下单请求中提交的备注信息,返回给商户 |
hmac | 参数签名 | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程。 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
status | 支付状态 | 初始化 INIT |
成功 SUCCESS | ||
失败 FAILED | ||
处理中 PROCESSING | ||
refundId | 退款流水号 | 退款流水号 |
requestId | 退款请求号 | 商户自定义请求号,不能重复 |
bankNumber | 退款银行订单号 | 退款银行订单号 |
refundAmount | 退款金额 | 退款金额 |
refundSubmissionTime | 退款提交时间 | 格式:yyyy-MM-dd HH:mm:ss |
refundCompleteTime | 退款完成时间 | 格式:yyyy-MM-dd HH:mm:ss |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
refuseId | 拒付流水号 | 拒付流水号 |
bankNumber | 拒付银行订单号 | 拒付银行订单号 |
refuseAmount | 拒付金额 | 拒付金额 |
refuseCompleteTime | 拒付完成时间 | 格式:yyyy-MM-dd HH:mm:ss |