DOCS

Retrieve an exchange rate

/

Получение курсов валют

Узнайте, как получить курс rate.

Zonos поддерживает получение актуальных курсов валют между двумя валютами через наш GraphQL API. Мы гарантируем курсы валют, которые мы рассчитываем между валютами. Хотя мы обновляем наши курсы каждые 10 минут, мы гарантируем курс rate с момента его получения на протяжении 90 дней.

Zonos гарантирует курсы валют только в тех случаях, когда мы обрабатываем международные платежи, такие как через Zonos Checkout или пользовательские интеграции с нашим Zonos Payments API. Для получения полной информации о том, как мы гарантируем курсы валют, ознакомьтесь с нашими Условиями обслуживания.

Создание нового объекта курса rate

Чтобы получить свежий курс rate между двумя валютами, вы можете использовать мутацию createExchangeRate через наш GraphQL API. createExchangeRate поддерживает коды валют source и target, а также тип 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.

Ранее созданные ставки не обновляются, когда вы их получаете, они зафиксированы во времени на момент их первоначального получения.

Mutation

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": ","
      }
    }
  }
}

Курсы обмена Google против Zonos курсов обмена 

Когда вы используете Google для получения курсов обмена, вы получите значение, отличное от того, что предоставляет наше API. Курс rate, который ваш клиент видит онлайн, не является потребительским rate. Если вы введете в Google текущий курс конверсии USD в GBP rate, вы увидите "бенчмарк" иностранного обменного rate. Это тот rate, по которому крупные международные банки обменивают сотни миллионов долларов, но никто не может купить по этому rate. Потребитель увидит этот бенчмарк rate плюс сборы, взимаемые компанией по обмену валют, когда курсы обмена Zonos не используются.

Другие сайты, которые вы видите, скорее всего, отображают курс обмена rate ради удобства, но на самом деле они не взимают с клиента плату в их иностранной валюте. Компании по кредитным картам и банки, выпускающие карту, будут взимать сборы за обмен валюты и иностранные транзакции с клиентов, которые покупают на сайтах, которые взимают плату в USD. Хотя они отображают валюту в GBP (или любой другой валюте), сумма, отображаемая им на checkout, не является той суммой, которую в конечном итоге заплатит клиент.

Как уже упоминалось, мы предлагаем гарантированный курс обмена rate. Дополнительные сборы, которые мы взимаем, учитывают постоянно колеблющийся рынок обмена. Изменения, вероятно, произойдут в течение 90-дневного гарантированного периода для первоначально полученного rate. Дополнительные сборы гарантируют, что сумма, отображаемая и оплачиваемая клиентом на checkout, является общей и окончательной стоимостью, которую они заплатят — никаких скрытых или неожиданных сборов позже.

Была ли эта страница полезной?