收款账户查询接口(商户→汇元通,必做接口)

功能描述

商户可通过此接口查询全球收款账户信息

接口地址

https://api.geoswift.com/va/account/query

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在汇元通系统的唯一身份标识 M
partnerId 服务商编号 varchar(9) 二级商户上属服务商商户在汇元通系统的唯一身份标识(如果发起商户自身即为主商户此项可不传) C
requestId 商户订单号 varchar(50) 创建收款账户时的商户订单号 M
hmac 参数签名 varchar(512) 商户生成的参数签名结果,获取hmac的方法请参考《Geoswift加解密流程规范》 M

示例

{ "merchantId": "G70000414", "requestId": "172527594873584189" }

请求返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 服务商编号 同请求参数
requestId 订单号 同请求参数
accountNo VA账号 全球收款账号
accountName 账户名称 同请求参数
accountShortName 账户简称 同请求参数
registryCountry 收款账户所在国家/地区 同请求参数
currency 币种 同请求参数
bankName 银行名称 银行名称
swiftCode SwiftCode SwiftCode编号
accountStatus 账户状态 INIT:初始化;
PROCESSING:处理中;
ACTIVE:已激活;
UNACTIVE:待激活;
CLOSE:关闭;
FAILED:失败;
status 请求状态 SUCCESS:成功
FAILED:失败
ERROR:错误
createDateTime 创建时间 订单创建时间
errorMessage 失败原因 失败原因
hmac 参数签名 汇元通生成的参数签名结果,验签过程请参考《Geoswift加解密流程规范》

示例

{ "forUse": "GOODS_TRADE", "serialNumber": "2c9696b091b1cca40191b27f5ce60012", "accountShortName": "VA jiancheng-0004", "accountName": "VA test-0002", "bankName": "DBS Bank (Hong Kong) Limited", "createDateTime": "2024-09-02 19:29:37", "accountStatus": "PROCESSING", "merchantId": "G70000422", "requestId": "172527594873584189", "accountNo": "799001*****00107", "hmac": "ej3bi6+qScOzO1RnglBo0OeQ==", "currency": "CAD,CNY,NOK,SGD,JPY,NZD,SEK,USD,EUR,GBP,AUD,CHF,DKK,HKD", "partnerId": "G70000414", "registryCountry": "HKG", "status": "SUCCESS" }