订单查询接口

功能概述

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

注:查询接口有每分钟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 可分账金额 可分账金额,单位:分
remark 备注 在下单请求中提交的备注信息,返回给商户
errorMessage 错误信息 错误信息
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

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