先决条件
创建货币兑换之前,请确保您已具备以下条件:- 具有货币兑换权限的有效 API 凭证。
- 需提供有效的汇款和收款货币账号。
- 您的源货币账户中有足够的余额。
API endpoint
要创建批量兑换,请向创建批量外汇转换endpoint 发送POST 请求。
endpoint
验证
在所有 API 请求中包含您的访问令牌:关键请求参数
示例请求(阿根廷)
curl
响应处理
成功响应
货币兑换成功后,系统会返回交易详情:关键响应字段
错误响应
资金不足
交易状态跟踪
通过多种渠道监控您的货币兑换情况:Webhooks(推荐)
交易状态变更时接收实时通知。最适用于生产环境。
状态 API endpoint
以编程方式查询事务状态。可用于轮询或恢复丢失的 webhook 通知。
Business Portal 视图
用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。
状态生命周期
完整参考请查看我们的交易状态文档,了解所有状态代码。
高级功能
使用汇率报价
预先生成报价,锁定优惠利率:- 生成报价:调用货币兑换报价 API
- 获取令牌:从响应中提取
exchangeRateToken - 应用代币:在您的批量兑换请求中包含代币
批量处理技巧
性能优化- 批量请求:尽可能将多个交易合并为单个 API 调用。
- 速率限制:对高容量处理实施指数退避。
- Webhook 处理:使用 webhook 而不是轮询来获取状态更新。
- 错误重试逻辑:针对临时故障实施智能重试机制。
测试与验证
沙盒环境
在我们的沙盒环境中测试您的集成:测试场景
上线前请验证以下场景:- 使用有效账户成功完成货币兑换
- 资金不足的错误处理
- 汇率代币到期
- 无效账号处理
- 网络超时场景
- Webhook 通知处理
资源与后续步骤
利用这些关键资源,最大限度地提高您的集成成功率。Webhook 集成
设置交易状态更新的实时通知。
报告 Business Portal
获取详细的分析、报告工具和对账功能。
交易监控
学习查询交易状态并实现全面跟踪。
API 参考
提供包含交互式示例的完整 endpoint 文档。
专业提示在部署到生产环境之前,务必先在我们的沙盒环境中测试您的工作流程。这可以确保您的错误处理、Webhook 处理和状态跟踪在所有场景下都能正常工作。
需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。

