Account Query Interface (Merchant→Geoswift,Mandatory Interface)

Function Description

Merchants can use this interface to query global collection account information.

Interface URL

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

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) The order number used when creating the account. M
hmac varchar(512) Parameter signature generated by the merchant; refer to the "Geoswift Encryption and Decryption Process Specification" for obtaining the hmac. M

Sample

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

Response Parameter List

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
currency Currency
bankName Bank name
swiftCode Swift Code
accountStatus Account status:
INIT
PROCESSING
ACTIVE (Activated)
UNACTIVE (Pending activation)
CLOSE
FAILED
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 verification

Sample

{ "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" }