订单查询接口

功能概述

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

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

参数示例

{ "totalRefundCount": "0", "serialNumber": "832f3f1bdab749849fd5bcf46d3ff7e3", "orderAmount": "1000", "orderCurrency": "CNY", "merchantId": "890000593", "requestId": "1527746602492", "hmac": "c5ab9be868a4b79872739362995b39db", "bindCardId": "", "remark": "备注", "totalRefundAmount": "0", "status": "SUCCESS" }