Allpay lets you display the price in one currency that is convenient for the customer, while charging in another currency.
For example, for customers in Canada you can display the price in CAD, while charging in ILS, so the funds are paid out to the merchant bank account without additional conversion.
In this scenario, the customer will see the amount in two currencies on the payment page, for example: 100 CAD (226 ILS). The actual charge will be made in Israeli shekels (ILS).
This format helps to:
- show the customer the price in a currency they understand;
- clearly explain which currency will be charged;
- reduce confusion when the customer later sees the charge in their bank statement.
Exchange rates are taken from Google Finance at the moment the payment page is opened.
Payment currency
Payment currency (parameter <span class="u-richtext-element">currency</span>) is the currency in which the actual charge is made and the funds are paid out to the merchant bank account.
The customer’s card currency does not matter — after the charge, the customer’s bank will convert the amount using its own exchange rate if the card is denominated in another currency.
By default, after registering in Allpay only ILS payment currency is available. You can enable USD and EUR according to this instruction.
Supported payment currencies
Euro — EUR
Israeli new shekel — ILS
United States dollar — USD
Валюта отображения
Display currency (parameter <span class="u-richtext-element">currency_display</span>) is the currency shown to the customer on the payment page.
Send this parameter only when the display currency is different from the payment currency.
If <span class="u-richtext-element">currency_display</span> is provided:
- the <span class="u-richtext-element">price</span> must be sent in the display currency;
- Allpay automatically converts the amount from <span class="u-richtext-element">currency_display</span> to <span class="u-richtext-element">currency</span> using current Google Finance exchange rate;
- the customer is always charged in the payment currency (<span class="u-richtext-element">currency</span>).
For example, for Europe customer you can display the price in EUR and charge in ILS. Or for customer from Canada display the price in CAD and charge in USD.
Supported display currencies
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
If the currency you need is not in the list, please contact support.
Examples of using <span class="u-richtext-element">currency_display</span> in API requests
Send <span class="u-richtext-element">currency_display</span> only when you need to display the price in one currency but charge in another.
Example 1
{
"items": [
{
"name": "Product name",
"price": "100",
"qty": "1",
"vat": "0"
}
],
"currency": "USD",
"currency_display": "CAD"
}
Allpay will convert 100 CAD to USD and the customer will be charged in USD.
At the time this article was written: 100 CAD = 72 USD, so the charge will be 72 USD.
If the account is not approved for USD, the system will automatically convert the amount to ILS (the default currency).
Example 2
{
"items": [
{
"name": "Product name",
"price": "100",
"qty": "1",
"vat": "0"
}
],
"currency_display": "CAD"
}
Because <span class="u-richtext-element">currency</span> is not provided, 100 CAD will be converted to ILS (the default currency), and the customer will be charged in ILS.
Example 3
{
"items": [
{
"name": "Product name",
"price": "100",
"qty": "1",
"vat": "0"
}
],
"currency": "CAD"
}
This request is invalid because CAD cannot be used as a payment currency. However, the system will not return an error. Instead, it will convert CAD to ILS (the default currency) and charge the customer in ILS.
To test different currency combinations, use the Allpay API tester.
