换汇

概述

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

业务流程

换汇预下单(询价)阶段

  • 换汇预下单(询价):该接口用于获取实时汇率报价,并生成换汇订单。
  • 调用换汇预下单接口获取汇率报价
  • 报价有效期内需要完成确认,否则需要重新询价
  • 返回换汇订单号 order_no 用于追踪业务流程

确认阶段

  • 换汇确认:该接口用于确认执行换汇交易。
  • 在报价有效期内调用换汇确认接口
  • 参数中的 order_no 为预下单返回的换汇订单号 order_no

结果查询

  • 查询换汇结果:该接口用于查询换汇交易的执行结果。
  • 定期调用查询接口获取换汇结果
  • 参数中的 order_no 为预下单返回的换汇订单号 order_no

监听换汇结果通知

  • 换汇结果通知webhook,用于接收异步通知。
  • 监听 FOREX 类型的回调通知
  • 通知内容中的 order_no 为预下单返回的换汇订单号 order_no

注意事项

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