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.
