The merchant must call this interface to create a global collection account. If multiple global collection accounts are needed, this interface should be called again. The account status will be notified to the merchant via the asynchronous notification interface.
| VA Account | Activation Time |
| US Dollar Account | Activated within 48 hours after successful account creation |
| Hong Kong-Based Multi-Currency Account | Activated immediately upon successful account creation |
Request endpoint：https://api.geoswift.com/va/account/create
| Name | Type&Length | Description | Required |
|---|---|---|---|
| merchantId | varchar(9) | The unique identifier of the merchant in the Geoswift system. | M |
| partnerId | varchar(9) | The unique identifier of the secondary merchant under the main merchant in the Geoswift system (this parameter can be omitted if the initiating merchant is the main merchant. | C |
| requestId | varchar(50) | Custom order number by the merchant; the submitted order number must be unique within the merchant's account transactions. | M |
| accountName | varchar(80) | Must be English name； The account name should closely resemble the merchant onboarding account name. For example, if the VA sub-merchant name provided during onboarding is "GGG Supply Chain Management (Asia) Limited", then the account name during registration can be "GGG Supply Chain Limited". The name must contain at least one space. Permissible characters: A-Z, a-z, 0-9, ".", ",", "-" and spaces. For US accounts, the length must not exceed 39 characters, and there must be a space within the name. A maximum of 20 characters can precede the space, and up to 19 characters can follow. For Hong Kong accounts, the length must not exceed 80 characters. | M |
| accountShortName | varchar(80) |
Account short name Permissible characters: A-Z, a-z, 0-9, ".", ",", "-" and spaces. |
O |
| registryCountry | varchar(3) | Three-letter ISO country code (refer to the country code table) | M |
| currency | varchar(3) | Supported currency, refer to the appendix currency code table./td> | O |
| forUse | 固定值 | Trading types: SERVICE_TRADE GOODS_TRADE |
M |
| notifyUrl | varchar(100) | URL for receving the notification of account opening results, POST method | M |
| hmac | varchar(512) | Parameter signature generated by the merchant; refer to the "Geoswift Encryption and Decryption Process Specification" for details | M |
| Name | Description |
|---|---|
| merchantId | Same as request parameter |
| partnerId | Same as request parameter |
| requestId | Same as request parameter |
| accountNo | VA Account: System-generated: 79 (country code, indicating HK) + 931 (GS organization number at DBS) + 7-digit sequential number, e.g., 799310000021. |
| accountName | Same as request parameter |
| accountShortName | Same as request parameter |
| registryCountry | Same as request parameter |
| currency | Same as request parameter |
| forUse | Same as request parameter |
| bankName | Bank name |
| bankAddress | Bank address |
| swiftCode | Bank Swift Code |
| status | Request Status: SUCCESS FAILED ERROR Note: Account opening result can be obtained through asynchronous notifications or query interface |
| createDateTime | Order creation time |
| errorCode | Error code, returned when the order fails or is canceled |
| errorMessage | Error description, returned when the order fails or is canceled |
| hmac | Parameter signature generated by Geoswift; refer to the Geoswift Encryption and Decryption Process Specification for the signature verification process |
| Name | Description |
|---|---|
| merchantId | Same as request parameter |
| partnerId | Same as request parameter |
| requestId | Same as request parameter |
| accountNo | Global collection account number |
| accountName | Same as request parameter |
| accountShortName | Same as request parameter |
| registryCountry | Same as request parameter |
| forUse | Same as request parameter |
| currency | Currency |
| bankName | Bank name |
| bankAddress | Bank address |
| swiftCode | Bank swift code |
| accountStatus | Account status: INIT PROCESSING ACTIVE (Activated) UNACTIVE (pending activation) CLOSE FAILED Note: The account must be in the ACTIVE status to receive payments |
| status | Request status: SUCCESS FAILED ERROR |
| createDateTime | Order creation time |
| errorMessage | Error message |
| hmac | Parameter signature generated by Geoswift; refer to the Geoswift Encryption and Decryption Process Specification for the signature verification process |