余额查询接口

功能描述

查询商户在Geoswift中的账户余额。

接口地址

https://apis.geoswift.com/overseas/account/query

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在汇元通系统的唯一ID M
partnerId 服务商编号 varchar(9) 二级商户上属服务商商户在汇元通系统的唯一身份标识(如果发起商户自身即为主商户此项可不传) C
requestId 订单号 varchar(50) requestId是由商户生成的ID。这个ID对于每个商户都是唯一的,可以用来确保请求的唯一性。如果该ID之前被使用过,系统将响应“order already exists” M
accountType 账户类型 固定值 账户类型: O
FUND_ACCOUNT 资金帐户
RESERVE_ACCOUNT 备用账户
SETTLEMENT_ACCOUNT 结算账户
注:目前结算账户只在币种为CNY时存在,非CNY时不存在。当不传递此参数时,默认值为FUND_ACCOUNT
currency 币种 varchar(3) 币种:CNY、USD、EUR、JPY、GBP、HKD、AUD、CAD、CNH、SGD M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "accountType": "FUND_ACCOUNT", "currency": "USD", "hmac": "SmHubsCII8HGGz+Qs...LYbOU34zOz/KhpQ==", "merchantId": "G70000608", "partnerId": "G70000414", "requestId": "MM20240225959237959708708865C1" }

查询返回参数列表

参数名称 参数中文名称 参数说明
requestId 订单号 requestId
merchantId 商户编号 商户在Geoswift系统中的唯一身份
partnerId 服务商编号 同请求参数
balance 余额 账户总余额,单位:元
accountType 账户类型 牌价类型:
FUND_ACCOUNT 资金帐户
RESERVE_ACCOUNT 备用账户
SETTLEMENT_ACCOUNT 结算账户
resMessage 错误返回信息 错误返回信息
currency 币种 币种:CNY、USD、EUR、JPY、GBP、HKD、AUD、CAD、CNH、SGD
availableBalance 可用余额 账户可用余额,单位:元
frozenAmount 冻结金额 账户冻结金额,单位:元
status 状态 SUCCESS 成功
FAILED 失败
ERROR 错误
timestamp 时间戳 时间戳, 当前时间的毫秒数
hmac 参数签名 汇元通生成的参数签名结果,验签过程请参考解密流程

示例

{ "balance": "0.00", "merchantId": "G70000608", "requestId": "MM20240225959237959708708865C1", "accountType": "FUND_ACCOUNT", "hmac": "IvTdk4ffyIqE1Fk...cOK2ydk3tA==", "resMessage": "SUCCESS!", "currency": "USD", "partnerId": "G70000414", "availableBalance": "0.00", "frozenAmount": "0.00", "status": "SUCCESS", "timestamp": "1746762648181" }