订单查询接口

功能概述

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

注:查询接口有每分钟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 支付方式 B2C 个人网银
B2B 企业网银
UNION_SCANCODE_PAY 银联扫码
EXPRESS_PAY 快捷支付
CREDIT_EXPRESS_PAY 信用卡快捷支付
DEBIT_EXPRESS_PAY 借记卡快捷支付
ALI_SCANCODE_PAY 支付宝扫码支付
ALIPAY_OFFICIAL_PAY “支付宝生活号支付
WEIXIN_SCANCODE_PAY 微信扫码支付
WEIXIN_OFFICIAL_PAY 微信-公众号支付
MINIAPPS_WEIXIN_PAY 微信-小程序支付
APPLE_PAY 苹果支付
ALIPAY_WAP_PAY 支付宝-WAP
APP_ALIPAY 支付宝APP支付
ALIPAY_B2C_PAY 支付宝B2C支付
MINIAPPS_ALI_PAY “支付宝-小程序支付
SCANCODE-EQRCODE_PAY-ALI 易码付-支付宝
SCANCODE-EQRCODE_PAY-WEIXIN 易码付-微信
SCANCODE-EQRCODE_PAY-WEBOX 易码付-微包
SCANCODE-EQRCODE_PAY-UNION 易码付-云闪付
AGREEMENT_PAY 协议支付
WAP 银联wap支付
APP_UNION 云闪付收银台支付
WEBOX_APP 微包app支付
WEBOX_CSP 微包扫码支付
WEBOX_SVC 微包服务号支付
APP_WEIXIN 微信APP支付
MERCHANT_ACCOUNT_PAY 企业账户支付
realBankSerialNumber 银行流水号 银行流水号
realBankRequestNumber 银行订单号 银行订单号
projectId 项目ID 项目的ID标识
bindCardId 绑卡id 用户绑卡id
splitMark 分账标识 DO_SPLIT 分账
NOT_DO_SPLIT 不分帐
canSplitAmount 未分账金额 该笔订单当前的剩余可分账金额,单位:分,未分账金额=可分账金额-已分账金额-待分账资金归集退款金额
orderSplitAmount 可分账金额 该笔订单的总可分账金额,固定值,单位:分,当订单的计费类型为“实时”时,可分账金额=订单金额-手续费,当订单的计费类型非“实时”时,可分账金额=订单金额
payMerchantId 付款商户商编 使用企业账户支付时,返回此参数
remark 备注 在下单请求中提交的备注信息,返回给商户
errorMessage 错误信息 错误信息
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

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