商户通过单笔订单查询接口查询首信易支付平台的订单状态,并且通过主动查询订单来获知订单信息。
注:查询接口有每分钟200次的限制,超过此限制会报错。
https://apis.5upay.com/onlinePay/query
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id,可在商户后台查看 | M |
requestId | 订单号 | varchar(50) | 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已终态的订单,商户平台不能以相同的订单号再次提交。 | 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 | 支付方式 | AGREEMENT_PAY 协议支付 |
realBankSerialNumber | 银行流水号 | 银行流水号 |
realBankRequestNumber | 银行订单号 | 银行订单号 |
projectId | 项目ID | 项目的ID标识 |
bindCardId | 绑卡id | 用户绑卡id |
splitMark | 分账标识 | DO_SPLIT 分账 |
NOT_DO_SPLIT 不分帐 | ||
canSplitAmount | 未分账金额 | 该笔订单当前的剩余可分账金额,单位:分,未分账金额=可分账金额-已分账金额-待分账资金归集退款金额 |
orderSplitAmount | 可分账金额 | 该笔订单的总可分账金额,固定值,单位:分,当订单的计费类型为“实时”时,可分账金额=订单金额-手续费,当订单的计费类型非“实时”时,可分账金额=订单金额 |
remark | 备注 | 在下单请求中提交的备注信息,返回给商户 |
errorMessage | 错误信息 | 错误信息 |
finalPaymentType | 支付类型 | BANK_CARD 银行卡 |
BALANCE 余额 | ||
用户实际支付的支付类型 | ||
收单商户与我司申请开通相关配置,交易成功后返回此参数 | ||
payerNameMd5 | 支付人名称MD5 | 实际支付用户的名称MD5格式收单商户与我司申请开通相关配置,且支付渠道支持同步该信息时,交易成功后返回此参数 |
bankCardNumberMd5 | 支付卡号MD5 | 用户实际支付所用银行卡的卡号MD5格式收单商户与我司申请开通相关配置,支付类型为银行卡,且支付渠道支持同步该信息时,交易成功后返回此参数 |
bankCardNumber | 支付卡号掩码 | 用户实际支付所用银行卡的卡号掩码格式收单商户与我司申请开通相关配置,支付类型为银行卡,且支付渠道支持同步该信息时,交易成功后返回此参数 |
bankCode | 支付银行编码 | 用户实际支付所用银行卡的所属银行编码收单商户与我司申请开通相关配置,支付类型为银行卡,且支付渠道支持同步该信息时,交易成功后返回此参数 |
feeAmount | 手续费金额 | 该笔订单首信易收取的手续费,单位:分,交易成功后返回此参数 |
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |
注:商户在处理首信易返回报文时,需考虑对未来新增字段的兼容处理,避免以后因新增字段而发生系统报错或影响原有字段的解析处理