If the merchant onboarding interface has been called successfully, the merchant can use this interface to query the sub-merchant onboarding information.
Endpoint: https://api.geoswift.com/va/declaration/query
| Name | Type&Length | Description | Required |
|---|---|---|---|
| merchantId | varchar(9) | The unique identifier of the merchant in the Geoswift system. | M |
| subMerchantId | varchar(9) | Required when the operation type(type) is MODIFY | O |
| requestId | varchar(50) | Merchant-defined order number. The submitted order number must be unique within the merchant's account transactions. If the operation type type is MODIFY, this parameter value must be consistent with the order number created initially. | M |
| hmac | varchar(512) | The parameter signature generated by the merchant. Refer to the "Geoswift Encryption and Decryption Process Specification" for details on how to obtain the HMAC. | M |
| Name | Description |
|---|---|
| merchantId | Same as the request parameter. |
| requestId | Same as the request parameter. |
| subMerchantId | Same as the request parameter. |
| declareStatus | Declaration Status: ACTIVATE CLOSE INIT NOTACTIVATE REPAYING |
| company | See the following table: Company Information |
| business | See the following table: Business Information. |
| beneficialList | See the following table: Beneficiary Information. |
| legalList | See the following table: Legal Representative Information. |
| authorizedList | See the following table: Authorized Person Information. |
| hmac | The parameter signature generated by Geoswift. Refer to the "Geoswift Encryption and Decryption Process Specification" for verification. |
| Name | Description |
|---|---|
| country | State or country of the company establishment |
| signedName | Company registered name |
| shortName | Company registered name |
| usedName | Former company name |
| brandName | Brand name |
| registerAddress | Company registered address |
| businessAddress | Company business address |
| addressType | Correspondence address |
| phone | Company contact phone number |
| br | Business Registration (BR) number |
| brStartDate | Business registration start date |
| brEndDate | Business registration end date |
| ci | Company Registration (CI) number |
| licenseNumber | Business license number |
| licenseNumberStartDate | Business license start date |
| licenseNumberEndDate | Business license end date |
| registerNumber | Company Registration Certificate Number |
| establishDate | Company establishment date |
| legalPersonName | Legal representative's name |
| companyType | Company type |
| companyTypeDesc | Description of company type |
| webSite | Company website |
| The official company contact email address |
| Name | Description |
|---|---|
| businessNature | Nature of business |
| productType | Products and services provided |
| tradeMode | Trading model |
| businessModeDesc | Description of business model |
| cashSourceCountry | Jurisdiction of Funds Source |
| cashSource | Source of Funds |
| cashSourceDesc | Description of funds source |
| enterCurrency | Incoming currency |
| outCurrency | Outgoing currency |
| enterForUse | Purpose of remittance funds |
| enterForUseDesc | Description of the purpose of remittance |
| lastYearSaleAmount | Sales amount of the past year |
| expectNumberPerMonth | Estimated number of transactions per month |
| expectAmountPerMonth | Estimated transaction amount per month (USD) |
| companyAssets | Company assets |
| branchCountry | Country where customer branches are located |
| beneficialCountry | Jurisdiction of the beneficiary |
| supplyCountry | Country where main suppliers are located |
| buyCountry | Country where main buyers are located |
| Name | Description |
|---|---|
| name | Name |
| idType | Identification type |
| idNo | Identification Number |
| address | Residential address |
| stockPercent | Shareholding Percentage. For example, if the shareholding is 30.87%, it returns 30.87. |
| Name | Description |
|---|---|
| name | Name |
| idType | Identification type |
| idNo | Identification Number |
| address | Residential address |
| Name | Description |
|---|---|
| name | Name |
| idType | Identification type |
| idNo | Identification Number |
| address | Residential address |