Merchants send quotation requests to the specified Geoswift URL and receive the returned result data.
https://apis.geoswift.com/fx/quotation/quote
| Name | Type& Max | Description | Requirement |
|---|---|---|---|
| merchantId | varchar(9) | The unique identity of the merchant in Geoswift system. Merchant can log in the merchant operation and management system to check | M |
| partnerId | varchar(9) | the secondary merchant's superior service provider merchant in the Geoswift system (can be omitted if the initiating merchant is the main merchant) | C |
| requestId | varchar(50) | number is generated by the merchant and must be unique on the merchant's own platform. Orders that are successful or canceled in the Geoswift system cannot be submitted again with the same order number. | M |
| sellCurrency | varchar(3) | E.g., USD | M |
| sellAmount | varchar(18) | Only one of this parameter or the buy Amount parameter must be passed. | M |
| buyCurrency | varchar(3) | E.g., CNY | M |
| buyAmount | varchar(18) | Only one of this parameter or the Sell Amount parameter must be passed. | M |
| hmac | varchar(500) | The result of parameter signature,generated by the merchant.For the method of obtaining hmac,please reference to "Geoswift encryption and decryption process specification" | M |
| Name | Description |
|---|---|
| merchantId | The same as the request parameter |
| partnerId | The same as the request parameter |
| requestId | The same as the request parameter |
| sellCurrency | The same as the request parameter |
| sellAmount | Sell Amount |
| buyCurrency | The same as the request parameter |
| buyAmount | Buy Amount |
| token | Quotation Token |
| rate | Merchant Rate |
| rateValidTime | E.g., 2025-10-20 00:00:00 |
| status | SUCCESS FAILED ERROR |
| errorMessage | Request status information |
| errorCode | Error Code |
| hmac | The result of parameter signature,generated by the merchant.For the method of obtaining hmac,please reference to "Geoswift encryption and decryption process specification" |