商户通过单笔订单查询接口查询首信易支付平台的订单状态,并且通过主动查询订单来获知订单信息。
注:查询接口有每分钟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 | 支付方式 | WEBOX_APP 微包app支付 |
realBankSerialNumber | 银行流水号 | 银行流水号 |
realBankRequestNumber | 银行订单号 | 银行订单号 |
projectId | 项目ID | 项目的ID标识 |
bindCardId | 绑卡id | 用户绑卡id |
splitMark | 分账标识 | DO_SPLIT 分账 |
NOT_DO_SPLIT 不分帐 | ||
canSplitAmount | 未分账金额 | 该笔订单当前的剩余可分账金额,单位:分,未分账金额=可分账金额-已分账金额-待分账资金归集退款金额 |
orderSplitAmount | 可分账金额 | 该笔订单的总可分账金额,固定值,单位:分,当订单的计费类型为“实时”时,可分账金额=订单金额-手续费,当订单的计费类型非“实时”时,可分账金额=订单金额 |
remark | 备注 | 在下单请求中提交的备注信息,返回给商户 |
errorMessage | 错误信息 | 错误信息 |
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |