子商户汇总余额查询接口

功能概述

商户通过此接口查询所有子商户的汇总余额。

接口地址

https://apis.5upay.com/serviceprovider/declaration/subMerchantBalanceQuery

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 服务商编号 varchar(9) 商户在首信易系统的唯一身份标识,商户可登录商户后台查看,需为服务商身份 M
requestId 订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已终态的订单,商户平台不能以相同订单号再次提交 M
currency 账户币种 固定值 CNY 人民币 M
USD 美元
EUR 欧元
JPY 日元
GBP 英镑
HKD 港币
AUD 澳元
CAD 加拿大元
SGD 新加坡元
CHF 瑞士法郎
SEK 瑞典克朗
DKK 丹麦克朗
NOK 挪威克朗
MOP 澳门元
accountType 账户类型 固定值 fundAccount 资金账户 O
settlementAccount 结算账户
reserveAccount 备用账户
allAccount 总账户
不传值时默认查总账户
dateTime 时间戳 varchar(50) 格式:yyyy-MM-dd HH:mm:ss M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "currency": "CNY", "dateTime": "2022-06-23 14:32:15", "hmac": "If71BpZRLmDAwEvJEwNj8yMkDlsgOAWe66GJwez0Wxs+MGi/2a/jBOT1MQG/k1iYftIIF0a8/n PVk9NrAju2qznQRi5VYozlAqjzi/DI9TLxC2ce1KAjFyVE6oj3dtejJyO7rhAgePeKaJ4BF1diM3IZZ q3zdf2PNkkfAOt9qELo8paMaKG9Mi/4veFdxeFn6nlb+8EyRq7Xof7Q5QpvKP/vCXB5tkUFvxYctuvg bGkSpMYx+GyERaVPw0iggMGPEAaLMfmzDxE6f4Wi88ionxCy+Wl8s5pPRvg+PC8851WebeGk0ByFZYV SAEvIaJf+CVv9ln8PuxsCbUyI4Oxo8g==", "merchantId": "892262217", "requestId": "1655965938060" }

返回参数列表

参数名称 参数中文名称 参数说明
merchantId 服务商编号 同请求参数
requestId 订单号 同请求参数
status 状态 SUCCESS 成功
ERROR 错误
currency 账户币种 同请求参数
balance 账户余额 所有子商户账户实时总余额的汇总值,单位为该币种的最小单位(日元为元,其余为分)
availableBalance 可用余额 所有子商户账户实时可用余额的汇总值,单位为该币种的最小单位(日元为元,其余为分)
frozenQuota 冻结金额 所有子商户账户实时冻结金额的汇总值,单位为该币种的最小单位(日元为元,其余为分)
dateTime 时间戳 格式:yyyy-mm-dd hh:mm:ss
errMsg 错误信息 status 为 ERROR 时,返回的错误提示描述
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "availableBalance": "135399", "balance": "195698", "currency": "CNY", "dateTime": "2022-06-23 14:32:15", "frozenQuota": "60299", "hmac": "If71BpZRLmDAwEvJEwNj8yMkDlsgOAWe66GJwez0Wxs+MGi/2a/jBOT1MQG/k1iYftIIF0a8/n PVk9NrAju2qznQRi5VYozlAqjzi/DI9TLxC2ce1KAjFyVE6oj3dtejJyO7rhAgePeKaJ4BF1diM3IZZ q3zdf2PNkkfAOt9qELo8paMaKG9Mi/4veFdxeFn6nlb+8EyRq7Xof7Q5QpvKP/vCXB5tkUFvxYctuvg bGkSpMYx+GyERaVPw0iggMGPEAaLMfmzDxE6f4Wi88ionxCy+Wl8s5pPRvg+PC8851WebeGk0ByFZYV SAEvIaJf+CVv9ln8PuxsCbUyI4Oxo8g==", "merchantId": "892262217", "requestId": "1655965938060", "status": "SUCCESS" }