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； For service mode: The account name must match the English name of the business as registered during the secondary merchant's onboarding. For non-service mode: The account name must match the English name of the business as registered during the main merchant's onboarding. |
M |
| accountShortName | varchar(80) | Account short name | 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 |