商户通过向汇元通指定的 URL 发送询价请求，并接收汇元通返回的结果数据。
https://apis.geoswift.com/fx/quotation/quote
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在汇元通系统的唯一身份标识 | M |
| partnerId | 服务商编号 | varchar(9) | 二级商户上属服务商商户在汇元通系统的唯一身份标识（如果发起商户自身即为主商户此项可不传） | C |
| requestId | 商户订单号 | varchar(50) | 订单号为商户自行拟定，提交的订单号必须在自身平台交易中唯一。汇元通系统成功或取消的订单，商户平台不能以相同的订单号再次提交。 | M |
| sellCurrency | 卖出币种 | varchar(3) | 示例：USD | M |
| sellAmount | 卖出金额 | varchar(18) | 以分为单位（如：1 元=100，与买入金额参数，只可且必须传其中一个参数） | M |
| buyCurrency | 买入币种 | varchar(3) | 示例：CNY | M |
| buyAmount | 买入金额 | varchar(18) | 以分为单位（如：1 元=100，与卖出金额参数，只可且必须传其中一个参数） | M |
| hmac | 参数签名 | varchar(512) | 商户生成的参数签名结果，获取hmac的方法请参考《Geoswift加解密流程规范》 | M |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| partnerId | 服务商编号 | 同请求参数 |
| requestId | 订单号 | 同请求参数 |
| sellCurrency | 卖出币种 | 同请求参数 |
| sellAmount | 卖出金额 | 卖出金额 |
| buyCurrency | 买入币种 | 同请求参数 |
| buyAmount | 买入金额 | 买入金额 |
| token | 询价token | 询价token |
| rate | 商户汇率 | 商户汇率 |
| rateValidTime | 失效时间 | 例：2025-10-20 00:00:00 |
| status | 请求状态 | SUCCESS：成功 FAILED：失败 ERROR：错误 |
| errorMessage | 错误描述 | 错误描述 |
| errorCode | 错误描述 | 错误描述 |
| hmac | 参数签名 | 汇元通生成的参数签名结果，验签过程请参考《Geoswift加解密流程规范》 |