商户需调用此接口创建全球收款账户，若需要多个全球收款账户时，需要再次调用此接口，账户的状态还需要通过异步通知接口通知给商户。
| VA账户 | 激活时间 |
| 美国美元账户 | 创建账户成功后48小时激活 |
| 香港多币种账户 | 创建账户成功后实时激活 |
请求地址：https://api.geoswift.com/va/account/create
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在汇元通系统的唯一身份标识 | M |
| partnerId | 服务商编号 | varchar(9) | 二级商户上属服务商商户在汇元通系统的唯一身份标识（如果发起商户自身即为主商户此项可不传） | C |
| requestId | 商户订单号 | varchar(50) | 商户自行拟定，提交的订单号必须在自身账户交易中唯一 | M |
| accountName | 账户名称 | varchar(80) | 英文名称； 账户名称需与商户入网开户名称相似 例如入网时传的VA账户子商户GGG Supply Chain Management (Asia) Limited 开户的时候可以传 GGG Supply Chain Limited 其中必须含有至少一个空格 可传入 A-Z、a-z、0-9、“.”、“,”、“-”及空格 申请美国账户，此项不能超过 39 位，且中间必须包含空格，空格前最多20位空格后最多19位 申请香港账户，此项不能超过 80 位 |
M |
| accountShortName | 账户简称 | varchar(80) | 账户简称 可传入 A-Z、a-z、0-9、“.”、“,”、“-”及空格 |
O |
| registryCountry | 收款账户所在国家/地区 | varchar(3) | 三位ISO国家编码（参见国家代码表） | M |
| currency | 币种 | varchar(3) | 支持币种参见附录币种编码表 | O |
| forUse | 贸易类型 | 固定值 | SERVICE_TRADE服务贸易 GOODS_TRADE货物贸易 |
M |
| notifyUrl | 通知地址 | varchar(100) | 通知开户结果，POST方式 | M |
| hmac | 参数签名 | varchar(512) | 商户生成的参数签名结果，获取hmac的方法请参考《Geoswift加解密流程规范》 | M |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| partnerId | 服务商编号 | 同请求参数 |
| requestId | 订单号 | 同请求参数 |
| accountNo | VA账号 | 系统自动生成79（国家代码表示HK）+931(GS在DBS的组织号)+7位自增序列，如：799310000021。 |
| accountName | 账户名称 | 同请求参数 |
| accountShortName | 账户简称 | 同请求参数 |
| registryCountry | 收款账户所在国家/地区 | 同请求参数 |
| currency | 币种 | 同请求参数 |
| forUse | 贸易类型 | 同请求参数 |
| bankName | 银行名称 | 银行名称 |
| bankAddress | 银行地址 | 银行地址 |
| swiftCode | SwiftCode | 银行SwiftCode |
| status | 请求状态 | SUCCESS：成功 FAILED：失败 ERROR：错误 注：开户结果通过异步通知或查询接口获取 |
| createDateTime | 创建时间 | 订单创建时间 |
| errorCode | 错误码 | 错误码，订单取消失败时返回 |
| errorMessage | 错误描述 | 错误描述，订单取消、失败时返回 |
| hmac | 参数签名 | 汇元通生成的参数签名结果，验签过程请参考《Geoswift加解密流程规范》 |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| partnerId | 服务商编号 | 同请求参数 |
| requestId | 商户订单号 | 同请求参数 |
| accountNo | VA账号 | 全球收款账号 |
| accountName | 账户名称 | 同请求参数 |
| accountShortName | 账户简称 | 同请求参数 |
| registryCountry | 收款账户所在国家/地区 | 同请求参数 |
| forUse | 贸易类型 | 同请求参数 |
| currency | 币种 | 币种 |
| bankName | 银行名称 | 银行名称 |
| bankAddress | 银行地址 | 银行地址 |
| swiftCode | SwiftCode | 银行SwiftCode |
| accountStatus | 账户状态 | INIT：初始化； PROCESSING：处理中； ACTIVE：已激活； UNACTIVE：待激活； CLOSE：关闭； FAILED：失败； 注：账户状态为已激活才可进行收款 |
| status | 请求状态 | SUCCESS：成功 FAILED：失败 ERROR：错误 |
| createDateTime | 创建时间 | 订单创建时间 |
| errorMessage | 失败原因 | 失败原因 |
| hmac | 参数签名 | 汇元通生成的参数签名结果，验签过程请参考《Geoswift加解密流程规范》 |