用户余额查询

功能概述

本接口用于查询商户在首信易支付所开通账户的余额,可通过系统实时调用本接口来观测账户余额

接口地址

https://apis.5upay.com/member/balanceQuery

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
partnerId 服务商编号 varchar(9) 服务商在首信易系统的唯一id,可在商户后台查看 O
requestId 订单编号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 O
currency 查询币种 varchar(15) CNY M
accountType 账户类型 固定值 allAccount 总账户 O
fundAccount 资金账户
settlementAccount 结算账户
reserveAccount 备用账户
不传默认为总账户 allAccount
dateTime 时间戳 varchar(50) 时间戳,格式:2018-03-08 17:01:54 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

以上参数值中不能包含以下特殊字符’”&<>()

参数示例

{ "merchantId": "890000593", "requestId": "1527231168976", "currency": "CNY", "dateTime": "2020-05-25 14:52:48", "hmac": null }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
accountList 余额信息 见下方账户余额信息表
dateTime 时间戳 时间戳,格式:2020-03-08 17:01:54
status 请求状态 SUCCESS 发起成功
ERROR 错误(此状态的返回参数见异常情况说明)
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

请求同步返回参数列表

参数名称 参数中文名称 参数说明
balance 账户余额 账户全部余额,分为单位
availableBalance 可用余额 账户可用余额,可结算、转账、退款、汇款等,分为单位
transitFund 冻结金额 不可用金额,分为单位
currency 币种 查询币种

参数示例

{ "dateTime": "2020-05-29 15:50:05", "merchantId": "890000593", "accountList": [ { "balance": 439451, "currency": "CNY", "transitFund": 290051, "availableBalance": 149400 } ], "hmac": "b83dfbc1eb979631c4d1748f165eb5ef", "status": "SUCCESS" }