商户通过单笔订单查询接口查询首信易支付平台的订单状态,并且通过主动查询订单来获知订单信息。
注:查询接口有每分钟200次的限制,超过此限制会报错。
https://apis.5upay.com/onlinePay/query
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id,可在商户后台查看 | M |
requestId | 订单号 | varchar(50) | 统一收单接口传入的requestid | M |
partnerId | 服务商id | varchar(9) | 服务商在首信易系统的唯一id,可在商户后台查看 | C |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
requestId | 订单号 | 同请求参数 |
partnerId | 服务商Id | 同请求参数 |
serialNumber | 交易流水号 | 交易流水号 |
totalRefundCount | 已退款次数 | 该支付订单共计退款次数 |
totalRefundAmount | 已退款金额 | 该支付订单共计退款金额 |
orderCurrency | 订单币种 | 默认人民币CNY |
orderAmount | 订单金额 | 单位:分,1元=100分 |
status | 状态 | INIT 初始化 |
CANCEL 取消 | ||
SUCCESS 成功 | ||
FAILED 失败 | ||
ERROR 错误 | ||
completeDateTime | 完成时间 | 支付完成时间 |
clearingOrg | 清算机构 | NUCC 网联 |
UNION_PAY 银联 | ||
paymentModeAlias | 支付方式 | SCANCODE-EQRCODE_PAY-WEBOX 易码付-微包 |
SCANCODE-EQRCODE_PAY-UNION 易码付-云闪付 | ||
splitMark | 分账标识 | NOT_DO_SPLIT 不分帐 |
realBankSerialNumber | 银行流水号 | 银行流水号 |
realBankRequestNumber | 银行订单号 | 银行订单号 |
remark | 备注 | 在下单请求中提交的备注信息,返回给商户 |
errorMessage | 错误信息 | 错误信息 |
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |