跳转到主要内容
批量货币转换 API 使您能够以最佳汇率和处理效率,通过编程方式执行单个或多个 交易。

先决条件

创建货币兑换之前,请确保您已具备以下条件:
  • 具有货币兑换权限的有效 API 凭证。
  • 需提供有效的汇款和收款货币账号。
  • 您的源货币账户中有足够的余额。
重要的您可以使用我们的货币兑换报价 API预先生成汇率报价,并在批量请求中包含 exchangeRateToken 以锁定汇率。

API endpoint

要创建批量兑换,请向创建批量外汇转换endpoint 发送 POST 请求。

endpoint

验证

在所有 API 请求中包含您的访问令牌:

关键请求参数

示例请求(阿根廷)

curl

响应处理

成功响应

货币兑换成功后,系统会返回交易详情:

关键响应字段


错误响应

资金不足


交易状态跟踪

通过多种渠道监控您的货币兑换情况:

Webhooks(推荐)

交易状态变更时接收实时通知。最适用于生产环境。

状态 API endpoint

以编程方式查询事务状态。可用于轮询或恢复丢失的 webhook 通知。

Business Portal 视图

用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。

状态生命周期

完整参考请查看我们的交易状态文档,了解所有状态代码。

高级功能

使用汇率报价

预先生成报价,锁定优惠利率:
  1. 生成报价:调用货币兑换报价 API
  2. 获取令牌:从响应中提取 exchangeRateToken
  3. 应用代币:在您的批量兑换请求中包含代币

批量处理技巧

性能优化
  • 批量请求:尽可能将多个交易合并为单个 API 调用。
  • 速率限制:对高容量处理实施指数退避。
  • Webhook 处理:使用 webhook 而不是轮询来获取状态更新。
  • 错误重试逻辑:针对临时故障实施智能重试机制。

测试与验证

沙盒环境

在我们的沙盒环境中测试您的集成:

测试场景

上线前请验证以下场景:
  • 使用有效账户成功完成货币兑换
  • 资金不足的错误处理
  • 汇率代币到期
  • 无效账号处理
  • 网络超时场景
  • Webhook 通知处理

资源与后续步骤

利用这些关键资源,最大限度地提高您的集成成功率。

Webhook 集成

设置交易状态更新的实时通知。

报告 Business Portal

获取详细的分析、报告工具和对账功能。

交易监控

学习查询交易状态并实现全面跟踪。

API 参考

提供包含交互式示例的完整 endpoint 文档。

专业提示在部署到生产环境之前,务必先在我们的沙盒环境中测试您的工作流程。这可以确保您的错误处理、Webhook 处理和状态跟踪在所有场景下都能正常工作。

需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。

最后修改于 2026年11月10日