跳转到主要内容
锁定汇率可让您在执行交易之前保证兑换价格,保护您和您的用户免受报价与执行之间市场波动的影响。 所有三种流程(收款、付款和批量兑换)都遵循相同的两步模式:
  1. 获取报价:调用货币兑换报价 API,并指定操作类型(payin、payout 或 CurrencyExchange)。您将收到一个 exchangeRateToken,其中包含有保证的汇率和到期时间。
  2. 使用令牌:在您的收款、付款或批量兑换请求中包含 exchangeRateToken。API 会自动应用已锁定的汇率。
以下各节以收款为例,但付款和批量兑换的结构类似。
汇率到期锁定的汇率仅在令牌的 expirationDate 之前有保证。如果令牌在您提交交易之前过期,该操作将使用当时的市场汇率。

为收款报价

当您希望在收取付款之前向用户显示汇率时,请使用此流程。

步骤 1:请求报价

请求
curl
回复

步骤 2:使用令牌提交收款

请求
curl
回复


curl

在结账前显示汇率

如果您正在构建结账流程,并希望在用户确认付款之前向其显示汇率,流程如下:
  1. 用户选择金额和货币。
  2. 您的后端调用货币兑换报价 API,并在 exchangeRateToken 参数中接收汇率。
  3. 您的前端显示:“您将支付 10,000 ARS ≈ 8.37 USD(汇率:0.000837)”
  4. 用户确认。
  5. 您的后端使用 exchangeRateToken 提交收款,以应用锁定的汇率。
只要您在令牌的 expirationDate 之前提交,就能保证用户看到的汇率即为应用于该交易的汇率。
设计提示:在界面中以倒计时形式显示 expirationDate(例如 “汇率有效期为 8 小时”)。这样可以设定正确的预期,并减少因会话之间汇率变动而产生的支持工单。

最后修改于 2026年11月10日