本接口用于查询商户在首信易支付所开通账户的余额,可通过系统实时调用本接口来观测账户余额
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 | 商户编号 | 同请求参数 |
accountList | 余额信息 | 见下方账户余额信息表 |
dateTime | 时间戳 | 时间戳,格式:2020-03-08 17:01:54 |
status | 请求状态 | SUCCESS 发起成功 |
ERROR 错误(此状态的返回参数见异常情况说明) | ||
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
balance | 账户余额 | 账户全部余额,单位为该币种的最小单位(日元为元,其余为分) |
availableBalance | 可用余额 | 账户可用余额,可结算、转账、退款、汇款等,单位为该币种的最小单位(日元为元,其余为分) |
transitFund | 冻结金额 | 不可用金额,单位为该币种的最小单位(日元为元,其余为分) |
currency | 币种 | 查询币种 |