订单查询接口

功能概述

商户通过单笔订单查询接口查询首信易支付平台的订单状态,并且通过主动查询订单来获知订单信息。

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 M
requestId 订单号 varchar(80) 该参数格式为:订单生成日期-商户编号-商户流水号。例如:20170101-888-12345。商户流水号为数字,每日内不可重复,并且不能包括除数字、英文字母和“-”外以其它字符。流水号可为一组也可以用“-”间隔成几组 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程。 M

以上参数值中不能包含以下特殊字符’”&<>()

参数示例

{ "merchantId": "888", "requestId": "20190813-888-123456", "hmac": "af291df5d288690d2b7d7bcff7dc5a74447ce1502c1edcc9293051bb6a517d68 6fbb31de72bfd14938d474fa6dd0afb82a2c222a6a345e41683d456a142e3376 c5c8f07dc5bc92dd5b09af316fa478a003189ed4d4c956d33162de11a8aec8ab 6abcf66b19833302780cffaa25c7e40bb9b2ccc59adc44e3fcb4632bce5d9cf9" }

响应参数列表

注:注意:当响应处理正常即 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的方法请参考请求加密流程。

响应参数列表(退款详情,refundDetails)

参数名称 参数中文名称 参数说明
status 支付状态 初始化 INIT
成功 SUCCESS
失败 FAILED
处理中 PROCESSING
refundId 退款流水号 退款流水号
requestId 退款请求号 商户自定义请求号,不能重复
bankNumber 退款银行订单号 退款银行订单号
refundAmount 退款金额 退款金额
refundSubmissionTime 退款提交时间 格式:yyyy-MM-dd HH:mm:ss
refundCompleteTime 退款完成时间 格式:yyyy-MM-dd HH:mm:ss

响应参数列表(拒付详情,refuseDetails)

参数名称 参数中文名称 参数说明
refuseId 拒付流水号 拒付流水号
bankNumber 拒付银行订单号 拒付银行订单号
refuseAmount 拒付金额 拒付金额
refuseCompleteTime 拒付完成时间 格式:yyyy-MM-dd HH:mm:ss

示例

{ "status": "SUCCESS", "pstatus": "SUCCESS", "statusDescription": "0000", "merchantId": "888", "paymentModeAlias": "Master", " requestId": "20190813-888-123456", "serialNumber": "123456", "bankNumber": "3456789098", "orderCurrency": "CNY", "orderAmount": "1.00", "submissionTime": "2019-08-13 01:12:30", "completeTime": "2019-08-13 01:12:31", "totalRefundCount": "1", "totalRefundAmount": "10.00", "refundDetails": [ { "status": "SUCCESS", "refundId": "816290053119947", "requestId": "12345", "bankNumber": "345678", "refundAmount": "1.00", "refundSubmissionTime": "2019-08-13 21:30:00", "refundCompleteTime ": "2019-08-13 21:30:01", }, ], "totalRefuseCount": "1", "totalRefuseAmount": "10.00", "refuseDetails": [ { "refuseId": "34567878", "bankNumber": "25657890", "refuseAmount": "1.00", "refuseCompleteTime": "2019-08-13 21:30:02", }, ], "remark": "test", "hmac": " af291df5d288690d2b7d7bcff7dc5a74447ce1502c1edcc9293051bb6a517d68 6fbb31de72bfd14938d474fa6dd0afb82a2c222a6a345e41683d456a142e3376 c5c8f07dc5bc92dd5b09af316fa478a003189ed4d4c956d33162de11a8aec8ab 6abcf66b19833302780cffaa25c7e40bb9b2ccc59adc44e3fcb4632bce5d9cf9", }