DOCS

Retrieve an exchange rate

/

检索汇率

了解如何检索汇率rate。

Zonos支持通过我们的GraphQL API获取两种货币之间的最新汇率。我们保证我们计算的货币之间的汇率。尽管我们每10分钟更新一次汇率,但我们保证从获取时起的汇率rate有效期为90天。

Zonos仅对我们处理国际支付的情况保证汇率,例如通Zonos Checkout或与我们的Zonos支付API的自定义集成。有关我们如何保证汇率的完整细节,请参阅我们服务条款

创建新的汇率rate对象

要获取两种货币之间的新汇率rate,您可以通过我们的GraphQL API使用createExchangeRate变更。createExchangeRate支持sourcetarget货币代码,以及rate类型。有关createExchangeRate变更的完整文档,请参阅我们GraphQL API参考。通过我们的API获取的汇率是特定于组织的。

变更

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation {
  exchangeRateCreate(
    input: {
      sourceCurrencyCode: GBP
      targetCurrencyCode: EUR
      type: MID_MARKET
    }
  ) {
    id
    rate
    sourceCurrencyCode
    targetCurrencyCode
  }
}

响应

1
2
3
4
5
6
7
8
9
10
{
  "data": {
    "createExchangeRate": {
      "id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
      "rate": 0.6391,
      "sourceCurrencyCode": "GBP",
      "targetCurrencyCode": "EUR"
    }
  }
}

检索现有的 rate

您可以使用 exchangeRate 查询和提供的 ID 来检索先前获取的汇率 rate 详细信息。如果您想查看历史汇率 rate 详细信息,或将其用于报告、用户界面等,这非常有用。您可以在 GraphQL API 参考 中查看可用字段的完整列表。

先前创建的汇率在检索时不会被刷新,它们的时间固定在最初获取时。

变更

1
2
3
4
5
query {
  exchangeRate(id: "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616") {
    // Field names here...
  }
}

响应

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "data": {
    "exchangeRate": {
      "id": "exchange_rate_1a021f23-8a63-4811-a8a3-6cce69f3a616",
      "rate": 0.6391,
      "sourceCurrencyCode": "CAD",
      "targetCurrencyCode": "GBP",
      "targetFormat": {
        "decimalDelimiter": ".",
        "symbol": "£",
        "thousandsDelimiter": ","
      }
    }
  }
}

谷歌汇率与Zonos汇率的比较 

当您使用谷歌查询汇率时,您得到的值与我们的API提供的值不同。您的客户在线查看的汇率不是消费者rate。如果您谷歌当前的美元对英镑的转换rate,您看到的是“基准”外汇rate。这是大型国际银行交换数亿美元的rate,但没有人能以这个rate购买。消费者将看到这个基准rate加上外汇公司收取的费用,当不使用Zonos汇率时。

您看到的其他网站很可能为了方便而显示汇率,但实际上并没有以客户的外币收费。发卡的信用卡公司和银行将向在以美元收费的网站购物的客户收取外汇和外币交易费用。尽管他们显示的货币是英镑(或其他任何货币),但在checkout时显示给他们的金额并不是客户最终将支付的金额。

如前所述,我们提供保证的汇率rate。我们收取的额外费用是为了应对不断波动的汇市。在最初获取的rate的90天保证期内,很可能会发生变化。额外的费用确保在checkout时显示和支付的金额是客户将支付的总和最终成本——之后没有隐藏或意外的费用。

这个页面有帮助吗?


有问题吗?

联系我们。