电子账户余额查询接口

功能概述

商户可通过此接口查询电子账户的余额

接口地址

https://apis.5upay.com/eaccount/accountBalance

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
requestId 订单号 varchar(50) 商户自行拟定,提交的订单号必须在自身账户交易中唯一 M
partnerId 服务商id varchar(9) 二级商户上属服务商商户在首信易系统的唯一身份标识(如果发起商户自身即为主商户此项可不传) C
accountNumber 银行账号 varchar(50) 银行电子账户账号 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格

参数示例

{ "merchantId": "896666131", "requestId": "1527231168976", "partnerId": "890001312", "accountNumber": "***", "hmac": "i0F9C6991JSLFiZ+eeDcdacfYnRw==" }

订单查询返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 服务商Id 同请求参数
requestId 订单号 同请求参数
accountNumber 银行账号 同请求参数
status 请求状态 SUCCESS 成功
FAILED 失败
ERROR 错误
errorMessage 错误信息 查询失败时返回错误信息
balance 总余额 该账户的实时总余额,单位:分
availableBalance 可用余额 该账户的实时可用余额,单位:分
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程
{ "balance": 9999885800, "merchantId": "899646896", "requestId": "1721959114439", "hmac": "WAwJCPTssXE2Cgi3qbLKqXmjhMtR9ptRQXN36Fw==", "partnerId": "896666813", "accountNumber": "8320***0391", "availableBalance": 9999885800, "status": "SUCCESS" }