商户日终余额查询

功能概述

本接口用于查询商户在首信易支付所开通账户的日终余额


注意:由于系统生成日终余额数据需要一定时间,请于上午09:00后查询前一日日终余额,否则查询结果可能为空

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 需要查询余额的商户的编号 M
partnerId 服务商编号 varchar(9) 服务商在首信易系统的唯一id,可在商户后台查看 C
snapshotDate 查询日期 varchar(10) 格式:yyyy-MM-dd, 需小于当前日期 M
currency 账户币种 固定值 CNY 人民币
USD 美元
EUR 欧元
JPY 日元
GBP 英镑
HKD 港币
AUD 澳元
CAD 加拿大元
CHF 瑞士法郎
DKK 丹麦克朗
NOK 挪威克朗
SGD 新加坡元
SEK 瑞典克郎
MOP 澳门元
TWD 新台币
THB 泰铢
KRW 韩元
NZD 新西兰元
M
queryAccountType 账户类型 固定值 allAccount 总账户
fundAccount 资金账户
settlementAccount 结算账户
reserveAccount 备用账户
不传值时默认查总账户日终余额
O
requestTime 时间戳 varchar(19) 时间戳,格式:yyyy-MM-dd HH:mm:ss M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

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

参数示例

{ "merchantId":"890000593", "snapshotDate":"2023-06-12", "currency":"CNY", "queryAccountType":"allAccount", "requestTime":"2023-06-14 13:36:47", "hmac":"XkARHAVb4rkgvJzYaYPDPTeROEqhKwTM0MYEcTxYi6Wl5FTqQ4XpjM0TvHymrblMNLMuULzEzrQ1V88alVWcPk Gc2/GC3VpV9OVxhc6cDmkfISYd6COIAX6OW3EPhMj8pHF1Gsi+udgLaehK2Gb03JjaQUw==", }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 服务商编号 同请求参数
snapshotDate 查询日期 同请求参数
currency 账户币种 同请求参数
queryAccountType 账户类型 同请求参数
snapshotBalance 日终余额 所查询日期的所查询账户的日终余额,单位为该币种的最小单位(日元为元,其余为分)
responseTime 时间戳 格式:yyyy-MM-dd HH:mm:ss
errorMessage 错误信息 查询状态为ERROR时返回具体错误信息
queryStatus 状态 SUCCESS 成功
ERROR 错误
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "snapshotDate":"2023-06-12", "queryStatus":"SUCCESS", "merchantId":"890000593", "responseTime":"2023-06-14 13:36:47", "currency":"CNY", "queryAccountType":"allAccount", "snapshotBalance":13095, "partnerId":"" "hmac":"aNt6IqYk+0Kqh1LUACfEH5eomsxBbFgVULHVqUf6bfZKdtelPDTs3M1pOnYsGrBaRqP0rbAMfcwcmzf9tMUbn5 720dUpN8FN8o5xU/n3XaObgnDbhCEE3BAfY2o83EewZBotdeGFRGM9FGAtm6h3oEqHw==", }