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

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

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

В таком сценарии на странице оплаты клиент увидит сумму сразу в двух валютах, например: <span class="u-richtext-element">100 CAD (226 ILS)</span>. Фактическое списание произойдет в шекелях (ILS).

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

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

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

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

Валюта платежа (необязательный параметр <span class="u-richtext-element">currency_payment</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">price</span> обязательно должна быть указан в валюте отображения;
• Allpay автоматически конвертирует сумму из <span class="u-richtext-element">currency_display</span> в <span class="u-richtext-element">currency_payment</span> по курсу Google Finance.
• списание всегда происходит в валюте платежа — <span class="u-richtext-element">currency_payment</span>, если она не передана или не поддерживается, то в ILS.
• Если валюта отображения и валюта платежа были разные, то в webhook вернется параметр <span class="u-richtext-element">currency_course</span> с примененным курсом конвертации.

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

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

Australian dollar — AUD

Azerbaijani manat — AZN

Canadian dollar — CAD

Chinese Yuan — CNY

Euro — EUR

Georgian lari — GEL

Japanese yen — JPY

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>, даже если он совпадает с параметром <span class="u-richtext-element">currency_payment</span>.

Пример 1

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

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_payment</span> не передан, 100 CAD будут сконвертированы в ILS (валюта по умолчанию), и списание произойдет в ILS.

Пример 3

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

API вернет ошибку, так как параметр <span class="u-richtext-element">currency_display</span> не передан.

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