# 换汇

## 概述

本文档介绍如何接入换汇功能，实现不同币种之间的兑换交易。换汇流程包括询价和确认两个步骤，支持多种主流货币的兑换。

## 业务流程

### 换汇预下单（询价）阶段

- [换汇预下单(询价)](/collection/apis/openapi/换汇/preorder)：该接口用于获取实时汇率报价，并生成换汇订单。
- 调用换汇预下单接口获取汇率报价
- 报价有效期内需要完成确认，否则需要重新询价
- 返回换汇订单号 `order_no` 用于追踪业务流程


### 确认阶段

- [换汇确认](/collection/apis/openapi/换汇/confirm)：该接口用于确认执行换汇交易。
- 在报价有效期内调用换汇确认接口
- 参数中的 `order_no` 为预下单返回的换汇订单号 `order_no`


### 结果查询

- [查询换汇结果](/collection/apis/openapi/换汇/inquiry)：该接口用于查询换汇交易的执行结果。
- 定期调用查询接口获取换汇结果
- 参数中的 `order_no` 为预下单返回的换汇订单号 `order_no`


### 监听换汇结果通知

- [换汇结果通知](/collection/apis/openapi/换汇/notify)：**webhook**，用于接收异步通知。
- 监听 `FOREX` 类型的回调通知
- 通知内容中的 `order_no` 为预下单返回的换汇订单号 `order_no`


## 注意事项

- 金额单位说明
  - 所有金额都使用币种最小单位
  - 例如：100.50 USD 应该传入 10050
- 汇率说明
  - 汇率表示1单位卖出货币可以兑换多少单位买入货币
  - 汇率保留6位小数