Управление валютой по API и список поддерживаемых валют

Allpay имеет встроенный конвертер валют, который позволяет показывать цену в удобной для клиента валюле. Эта опция необходима бизнесам, которые продают за рубеж.

Курсы валют берутся с Google Finance в момент, когда клиент открывает страницу оплаты.

Валюта платежа

Валюта платежа — это валюта, в которой совершается фактическая оплата. Именно в этой валюте происходит списание с карты клиента. Если валюта карты клиента отличается от валюты платежа, списание все равно будет в валюте платежа, которую банк сконвертирует в валюту карты по своему курсу.

Зачисление на ваш банковский счет всегда происходит в валюте платежа.

‍По умолчанию всем пользователям доступна одна валюта платежа: ILS. Возможно добавить валюты USD и EUR согласной этой инструкции. По индивидуальному запросу в поддержку можно также получить разрешение на процессинг GBP.

В API за валюту платежа отвечает параметр <span class="u-richtext-element">currency</span>

Список поддерживаемых валют платежа

Euro — EUR — €

Israeli new shekel — ILS — ₪

Pound sterling — GBP — £

United States dollar — USD — $

Валюта отображения

Валюта платежа — это любая валюта которую можно показывать на странице оплаты для удобства клиента. Например, для клиентов из европы можно показывать сумму в EUR, а для клиентов из каналы CAD. Данная валюта будет сконвертирована в валюту платежа по текущему курсу Google Finance и списание прозойдет в валюте платежа.

В API за валюту платежа отвечает параметр <span class="u-richtext-element">currency_display</span>. Передавайте данные параметр только в том случае, если валюта отображения и валюты платежа отличаются.

Цены передаются в валюте отображения, а списания всегда и без исключений происходят в валюте платежа.

Список поддерживаемых валют отображения

Australian dollar — AUD — A$

Azerbaijani manat — AZN — ₼

Canadian dollar — CAD — CA$

Euro — EUR — €

Georgian lari — GEL — ₾

Israeli new shekel — ILS — ₪

Kazakhstani tenge — KZT — ₸

Norwegian krone — NOK — kr

Pound sterling — GBP — £

Russian ruble — RUB — ₽

Thai baht — THB — ฿

Ugandan shilling — UGX — Ush

United Arab Emirates dirham — AED — Dh

United States dollar — USD — $

Ukrainian hryvnia — UAH — ₴

Если в списке нет нужной валюты — напишите в поддержку.

Примеры использования currency_display в API запросах

Передавайте <span class="u-richtext-element">currency_display</span> только когда необходимо отобразить цену в одной валюте, а списать в другой. В таком случае на странице оплаты будет показана двойная цена, например: 100 CAD (72 USD).

Пример 1

{  
  "items": [
    {
      "name": "Product name",
      "price": "100",
      "qty": "1",
      "vat": "0"
    }
  ],
  "currency": "USD",
  "currency_display": "CAD"
  }

Allpay поймет этот запрос следующим образом: 100 CAD нужно сконвертировать в USD и списать с карты клиента. На момент написания справки, 100 CAD = 72 USD, поэтому списаны будут 72 USD. Если для аккаунта не одобрены USD, система сконвертирует CAD в ILS (валюту по умолчанию).

Пример 2

{  
  "items": [
    {
      "name": "Product name",
      "price": "100",
      "qty": "1",
      "vat": "0"
    }
  ],  
  "currency_display": "CAD"
  }

Так как параметр currency не передан, 100 CAD будут сконвертированы в ILS (валюта по умолчанию) и списание пройдет в ILS.

Пример 3

{  
  "items": [
    {
      "name": "Product name",
      "price": "100",
      "qty": "1",
      "vat": "0"
    }
  ],  
  "currency": "CAD"
  }

Запрос некорректен, так как валютой платежа не может быть CAD. Однако система не вернет ошибку, она сконвертирует CAD в ILS (валюту по умолчанию) и спишет ILS.

Чтобы симулировать различные комбинации валют используйте Allpay API tester.