订单查询接口

功能概述

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

注:查询接口有每分钟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": "890000593", "requestId": "1527746602492", "hmac": null }

订单查询返回参数列表

参数名称 参数中文名称 参数说明
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 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

注:商户在处理首信易返回报文时,需考虑对未来新增字段的兼容处理,避免以后因新增字段而发生系统报错或影响原有字段的解析处理

参数示例

{ "totalRefundCount": "0", "serialNumber": "832f3f1bdab749849fd5bcf46d3ff7e3", "orderAmount": "1000", "orderCurrency": "CNY", "merchantId": "100000050", "requestId": "1527746602492", "hmac": "c5ab9be868a4b79872739362995b39db", "bindCardId": "959e138ad2e290328e8d59fd124c618f", "remark": "备注", "totalRefundAmount": "0", "bankCardNumber": "623058***6188", "bankCardNumberMd5": "d53bb12384640f96af54655115d2f114", "bankCode": "PINGANBANK", "payerNameMd5": "ffe57baabbe47aed7394004c790ef5da", "finalPaymentType": "BANK_CARD", "usersSign": "bc306ae84da567f68d31d4596537885d", "status": "SUCCESS" }