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

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

Например, для клиентов из Канады цену можно отображать в CAD, а списание выполнять в ILS, чтобы средства зачислялись на банковский счет без дополнительной конвертации.

В таком сценарии на странице оплаты клиент увидит сумму сразу в двух валютах, например: 100 CAD (226 ILS). Фактическое списание произойдет в шекелях (ILS).

Такой формат позволяет:

• показать клиенту цену в привычной ему валюте;
• заранее объяснить, в какой валюте произойдет списание;
• избежать вопросов при просмотре банковской выписки.

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

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

Валюта платежа (параметр <span class="u-richtext-element">currency</span>) — это валюта, в которой происходит фактическое списание с карты клиента и зачисление средств на счет бизнеса.

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

По умолчанию после регистрации в Allpay доступна одна валюта платежа — ILS. Валюты USD и EUR можно подключить дополнительно согласно инструкции.

Поддерживаемые валюты платежа

Euro — EUR

Israeli new shekel — ILS

United States dollar — USD

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

Валюта отображения (параметр <span class="u-richtext-element">currency_display</span>) — это валюта, в которой цена отображается клиенту на странице оплаты.

Передавайте этот параметр только если валюта отображения отличается от валюты платежа.

Если параметр <span class="u-richtext-element">currency_display</span> передан:

• параметр <span class="u-richtext-element">price</span> обязательно должен быть указан в валюте отображения;
• Allpay автоматически конвертирует сумму из <span class="u-richtext-element">currency_display</span> в <span class="u-richtext-element">currency</span> по курсу Google Finance.
• списание всегда происходит в валюте платежа — <span class="u-richtext-element">currency</span>

Например, клиенту из Европы можно показать цену в EUR, а списать в ILS. Клиенту из Канады показать цену в CAD, а списать в USD.

Поддерживаемые валюты отображения

Australian dollar — AUD

Azerbaijani manat — AZN

Canadian dollar — CAD

Euro — EUR

Georgian lari — GEL

Israeli new shekel — ILS

Kazakhstani tenge — KZT

Norwegian krone — NOK

Pound sterling — GBP

Russian ruble — RUB

Thai baht — THB

Ugandan shilling — UGX

United Arab Emirates dirham — AED

United States dollar — USD

Ukrainian hryvnia — UAH

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

Примеры использования <span class="u-richtext-element">currency_display</span> в API-запросах

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

Пример 1

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

‍

100 CAD будут сконвертированы в USD и списаны с карты клиента. На момент написания справки 100 CAD = 72 USD → будет списано 72 USD.

Если для аккаунта не разрешена работа с USD, система автоматически сконвертирует сумму в ILS (валюта по умолчанию).

Пример 2

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

‍

Так как параметр <span class="u-richtext-element">currency</span> не передан, 100 CAD будут сконвертированы в ILS (валюта по умолчанию), и списание произойдет в ILS.

Пример 3

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

‍

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

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