商户余额查询

功能概述

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

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
partnerId 服务商编号 varchar(9) 服务商在首信易系统的唯一id,可在商户后台查看 O
requestId 订单编号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 O
currency 查询币种 varchar(15) CNY 人民币
USD 美元
EUR 欧元
JPY 日元
GBP 英镑
HKD 港币
AUD 澳元
CAD 加拿大元
CHF 瑞士法郎
DKK 丹麦克朗
NOK 挪威克朗
SGD 新加坡元
SEK 瑞典克郎
MOP 澳门元
TWD 新台币
THB 泰铢
KRW 韩元
NZD 新西兰元
M
accountType 账户类型 固定值 allAccount 总账户
fundAccount 资金账户
settlementAccount 结算账户
reserveAccount 备用账户
不传默认为总账户 allAccount
O
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 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

余额信息表(accountList)

参数名称 参数中文名称 参数说明
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" }