Help Center

The payment page supports languages: Arabic, English, French, German, Hebrew, Italian, Russian and Spanish.

The language is detected automatically based on the customer’s browser language, so each customer sees the payment page in their own language. If the browser language is not supported or cannot be detected, English will be set by default.

To manually control the language of the payment page, in the <span class="u-richtext-element">More</span> section of the payment link settings, change the <span class="u-richtext-element">Auto-detect (browser language)</span> option to the language you need.

The customer will then see the payment page in that language, regardless of their browser settings. The language switcher will still remain available on the checkout page.

The payment email notification is sent to the customer in the same language that was selected on the payment page at the time the payment was made. For example, if the payment page was opened in Hebrew, the email notification will also be sent in Hebrew. Example of a payment email notification.

Translation of additional fields

If you add custom fields to the payment page, their labels can be translated into all four languages. This makes the payment page convenient for a multilingual audience. For more details, see the article about additional fields.

Language control via API

For payments initiated from your website (i.e., not through payment links created in Allpay), the payment page language can be controlled via the API according to the documentation.

By default, automatic detection based on the browser settings applies.

After payment, customer receives an email notification about the payment. Make sure this feature is enabled in <span class="u-richtext-element">Settings</span> -> <span class="u-richtext-element">Notifications</span>

An email notification by itself is not a receipt.

The notification is sent in the same language that was selected on the payment page at the time the payment was made. For example, if the payment page was opened in English, the customer will receive the notification in English as well.

If you enable integration with EasyCount or Morning digital invoicing systems, the receipt will be created automatically, and a button for downloading it will be added to the notification.

Example of email notification

In Allpay, the plan is billed monthly. After registration, you get a 7-day trial period. All paid modules are charged to the internal balance, and once a month the outstanding amount is charged to the linked card.

Subscription fee and processing fees

The subscription fee and payment processing fees are different charges.

The subscription fee is charged to your card once a month. Payment processing fees are charged separately for each successful payment and are deducted from your payout.

Trial period and billing date

After registration, every client gets a 7-day trial period. At the end of the trial period, the system will charge the first payment for the next billing period.

The date of the first charge becomes the fixed monthly billing date for the plan. It does not change in the future.

For example, if you registered on March 10, the trial period will end on March 17. On that day, the system will charge the first payment for the next billing period. The following charges will take place on the 17th of each month.

How the internal balance works

All paid services and modules that you activate during the month are charged to the internal Allpay balance in <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Plan</span> → <span class="u-richtext-element">Billing</span>.

In the standard scenario, you do not need to top up the balance in advance. On the monthly billing date, the balance is charged for the next billing period. Immediately after that, the system charges this amount to the linked card, and the balance returns to zero.

If the card charge fails, the outstanding amount remains on the balance, and the balance stays negative until the debt is paid.

If a new module with a subscription fee is activated in the middle of a billing period, its cost is calculated proportionally to the time remaining until the next billing date.

If a module with a paid activation fee but no subscription fee is activated in the middle of a billing period, the activation fee is charged to the balance when the module is connected.

In some cases, the balance can be topped up in advance by bank transfer through support. This is usually used by companies that do not have a corporate card.

Canceling your Allpay subscription

You can cancel your subscription at any time. To do this, click “Disable all” in <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Plan</span>.

After cancellation, the service will continue to work and payments will continue to be processed until the end of the paid period. After that, the service will be disabled, and no new debt will be charged for the next billing period.

The “Disable all” button disables all paid services at once:

• the main payment processing service;
• the Subscriptions module;
• the Shopify module, if it was active;
• other paid modules, if they were active.

If you want to disable only one module, you need to do this in <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Payment modules</span>.

After the service is disabled, your account and payment history are saved. If needed, you will still be able to log in to your account and view previous transactions. The service can always be activated again to resume accepting payments.

If there is an outstanding debt on the balance when the service is reactivated, it will be paid immediately after the service is activated or a new card is linked.

Failed charges

If the system cannot charge the card, an error message will appear in the Allpay interface. An email is also sent for each failed charge.

The system makes four charge attempts in total:

Attempt 1 — the first failed charge.

Attempt 2 — 2 days after the first attempt.

Attempt 3 — 10 days after the first attempt.

Attempt 4 — one month after the first attempt.

Until the final charge attempt, the service continues to work as usual. If the debt is not paid after the fourth attempt, payment processing will be suspended.

The unpaid debt will remain on the internal balance. It must be paid before you can continue using the service.

Four charge attempts during the month give you enough time to fix the card issue without losing the ability to accept payments.

You can view the charge attempt history in <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Plan</span> → <span class="u-richtext-element">Payment methods</span>.

How to pay an outstanding debt

To pay an outstanding debt, add a valid card in <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Plan</span> → <span class="u-richtext-element">Payment methods</span>, or open the menu of an already linked card by clicking the three dots and select “Try again”.

Before trying again, make sure the reason for the failed charge has been fixed. For example, check that the card has enough funds, is not blocked, and is allowed for online payments.

Payment methods

The card you added during registration becomes the main payment method for the plan.

In <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Plan</span> → <span class="u-richtext-element">Payment methods</span>, you can:

• delete a card;
• add a backup card;
• set another card as the main payment method;
• manually retry a charge if there was a card payment error.

If several cards are added, the system first tries to charge the card marked as the main one. If the charge from the main card fails, the system automatically tries to charge the backup card.

The backup card is used only if the charge from the main card fails.

For example, you can add a new card and set it as the main payment method. In this case, the previous card will become the backup card.

Разработчики платформ, которым требуется платежное решение, могут интегрироваться с Allpay.

Такая интеграция может быть добавлена в раздел интеграций Allpay на сайте и в приложении. Она станет доступна клиентам Allpay как готовый способ подключения вашей платформы.

Эта статья в процессе создания.

Требования

Чтобы ваша платформа была добавлена в каталог интеграций Allpay, должны быть соблюдены следующие условия:

1. Вы не участвуете в партнерской или реферальной программе Allpay.
   ‍Такая интеграция строится на принципе взаимного продвижения.
2. Интеграция должна быть предварительно согласована с Allpay.
   ‍Ваша платформа должна быть востребована в Израиле и уже использоваться реальными клиентами.
3. Поддержка интеграции.
   Обеспечение работоспособности интеграции и клиентской поддержки на постоянной основе.

Как начать

Чтобы согласовать интеграцию вашей платформы, напишите в поддержку Allpay и кратко опишите:

• вашу платформу;
• кто ваши клиенты;
• как именно вы хотите использовать платежи Allpay;
• какой способ интеграции планируете: ручной или автоматизированный;
• есть ли уже клиенты, которым требуется такая интеграция.

Способы интеграции

Интеграция с Allpay может быть реализована двумя способами:

• ручная интеграция;
• автоматизированная интеграция.

Ручная интеграция

При ручной интеграции вы реализуете подключение на своей стороне и размещаете на своем сайте инструкцию для клиентов.

Клиенту потребуется:

1. Открыть раздел интеграций в кабинете Allpay.
2. Создать API-ключи.
3. Скопировать ключи и вставить в настройках вашей платформы.

Техническое участие Allpay для такой интеграции обычно не требуется. После того как интеграция реализована на вашей стороне, пришлите нам информацию о вашей платформе. Мы проверим ее и после согласования добавим вашу платформу в каталог интеграций Allpay.

Автоматизированная интеграция

Автоматизированная интеграция позволяет подключить платформу без ручного копирования API-ключей. Пользователь нажимает кнопку подключения в кабинете Allpay, подтверждает связку на стороне вашей платформы, а API-ключи передаются автоматически.

Перед началом реализации Allpay выдает вашей платформе:

<span class="u-richtext-element">partner_id</span> — индивидуальный номер интеграции;

<span class="u-richtext-element">secret_key</span> — секретный ключ для подписи и проверки серверных запросов.

<span class="u-richtext-counter">1</span>Переход из Allpay на страницу вашей платформы

Пользователь открывает в кабинете Allpay раздел<span class="u-richtext-element">Настройки</span> → <span class="u-richtext-element"> Интеграции</span> → <span class="u-richtext-element"> Ваша платформа</span> и нажимает кнопку подключения.

Allpay генерирует одноразовый токен для связки аккаунтов и перенаправляет пользователя на страницу подтверждения на стороне вашей платформы, например:

https://your-platform.com/connect?token=TOKEN

Где <span class="u-richtext-element">TOKEN</span> — одноразовый токен, созданный Allpay.

Стандартный срок действия токена — 1 час.

<span class="u-richtext-counter">2</span>Подтверждение подключения на стороне вашей платформы

На вашей стороне пользователь подтверждает подключение под своим аккаунтом.

После подтверждения ваша платформа перенаправляет пользователя обратно на универсальный endpoint Allpay:

https://allpay.to/services/endpoints/exchange.php?act=connect&partner_id=PARTNER_ID&token=TOKEN&external_uid=USER_ID

Где:

<span class="u-richtext-element">act=connect</span> — действие подключения интеграции;

<span class="u-richtext-element">partner_id</span> — индивидуальный номер интеграции;

<span class="u-richtext-element">token</span> — одноразовый токен, созданный Allpay;

<span class="u-richtext-element">external_uid</span> — внутренний идентификатор пользователя на вашей платформе.

<span class="u-richtext-counter">3</span>Создание и передача API-ключей на вашу платформу

После проверки токена Allpay связывает пользователя Allpay с пользователем вашей платформы и отправляет API-ключи <span class="u-richtext-element">api_login</span> и <span class="u-richtext-element">api_key</span> на ваш endpoint.

Пример endpoint на стороне вашей платформы:

POST https://your-platform.com/allpay/partner/exchange

Тело запроса:

{  
  "external_uid": "USER_ID",  
  "api_login": "API_LOGIN",  
  "api_key": "API_KEY",  
  "sign": "SIGNATURE"
}

Где:

<span class="u-richtext-element">external_uid</span> — идентификатор пользователя на вашей платформе;

<span class="u-richtext-element">api_login</span> — API login пользователя Allpay;

<span class="u-richtext-element">api_key</span> — API key пользователя Allpay;

<span class="u-richtext-element">sign</span> — подпись запроса.

<span class="u-richtext-counter">4</span>Подпись запроса

Серверный запрос с API-ключами подписывается с помощью HMAC SHA-256.

Формат подписи:

hash_hmac('sha256', $payload_json, $secret_key);

Где:

<span class="u-richtext-element">$payload_json</span> — JSON-тело запроса;

<span class="u-richtext-element">$secret_key</span> — индивидуальный секретный ключ.

<span class="u-richtext-counter">5</span>Ответ вашей платформы

После успешного получения и сохранения ключей ваша платформа должна вернуть успешный ответ, например:

{  
"ok": true
}

После этого Allpay отмечает интеграцию как активную.

Что нужно подготовить на стороне вашей платформы

Для автоматизированной интеграции вам потребуется подготовить:

1. Страницу подтверждения подключения
   На эту страницу Allpay будет перенаправлять пользователя после нажатия кнопки подключения.
2. Редирект обратно в Allpay после подтверждения
   После подтверждения подключения ваша платформа должна вернуть пользователя в Allpay, передав <span class="u-richtext-element">partner_id</span>, <span class="u-richtext-element">token</span> и <span class="u-richtext-element">external_uid</span>.
3. Endpoint для приема API-ключей
   ‍На этот endpoint Allpay отправит <span class="u-richtext-element">api_login</span> и <span class="u-richtext-element">api_key</span> пользователя.
4. Безопасное хранение API-ключей
   Полученные ключи должны храниться на вашей стороне в защищенном виде.
5. Обработку успешного и неуспешного подключения
   Ваша платформа должна корректно обрабатывать случаи, когда подключение завершилось успешно, было отменено пользователем или завершилось ошибкой.

Требования безопасности

При автоматизированной интеграции необходимо соблюдать следующие требования:

1. Передача только по HTTPS
   Все запросы между Allpay и вашей платформой должны выполняться только по HTTPS.
2. Подпись серверных запросов
   Серверный запрос с API-ключами должен быть подписан с помощью HMAC SHA-256 или другого согласованного механизма подписи.
3. Безопасное хранение ключей
   ‍Полученные <span class="u-richtext-element">api_login</span> и <span class="u-richtext-element">api_key</span> должны храниться на вашей стороне в защищенном виде.
4. Активация только после успешного обмена ключами
   Интеграция не должна считаться активной только после перехода пользователя по ссылке. Статус подключения должен меняться на активный после успешной передачи и сохранения API-ключей.

Отключение интеграции

Если пользователь отключает интеграцию на стороне вашей платформы, вы должны удалить сохраненные API-ключи у себя.

Дополнительно ваша платформа должна отправить в Allpay POST-запрос на отключение интеграции:

POST https://allpay.to/services/endpoints/exchange.php?act=disconnect&partner_id=PARTNER_ID

Тело запроса:

{  
  "external_uid": "USER_ID",  
  "sign": "SIGNATURE"
}

Где:

<span class="u-richtext-element">external_uid</span> — идентификатор пользователя на вашей платформе;

<span class="u-richtext-element">sign</span> — подпись запроса.

Запрос на отключение также подписывается с помощью <span class="u-richtext-element">secret_key</span>.

Если пользователь отключает интеграцию из кабинета Allpay, Allpay может отправить уведомление об отключении на endpoint вашей платформы. Формат такого запроса согласовывается отдельно.

<span id="info">Информация для каталога интеграций</span>

После того как техническая часть завершена и интеграция работает, пришлите следующую информацию для добавления вашей платформы в каталог интеграций Allpay:

• логотип платформы в формате SVG;
• краткое описание платформы до 200 символов;
• расширенное описание платформы до 360 символов;
• контакты для технической поддержки интеграции: email и WhatsApp или Telegram;
• информацию о том, поддерживает ли ваша интеграция рассрочку, рекуррентные платежи и возвраты платежей;
• ссылку на инструкцию по подключению Allpay на вашем сайте.

Рекомендации по брендингу Allpay

Используйте корректное написание бренда:

• правильно: Allpay;
• неправильно: AllPay, All Pay, allpay.

Используйте официальный логотип Allpay.

‍

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

Chinese Yuan — CNY

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.

Allpay supports Visa, Mastercard, American Express, Diners, Discover, JCB, and Isracard bank cards.

Current rates are listed at pricing page.

The commission rate depends on four factors:

1. Business turnover

The higher the average monthly turnover of the business, the lower the commission rate.

Average monthly turnover is calculated as the total amount of all successful payments over the last 3 months, minus refunds and chargebacks, divided by 3.

If payments were made in different currencies, the turnover is converted to ILS.

Turnover is recalculated automatically at the end of each day. If the business moves into a different turnover tier, the corresponding commission rate is applied automatically.

2. Card brand

Visa and Mastercard have lower rates.

American Express and Diners have higher rates because these brands are considered premium and provide cardholders with various benefits, which are paid for by the business.

3. Local or international payment

Payments made with cards or wallets issued in Israel have lower rates.

International payments follow a longer processing path before they are included in a payout, so the commission rate for them is higher.

4. Whether the card is a business or personal card

Transactions made with business cards may include an additional fee of 1.5% to 1.75%.

This fee is added by payment systems and issuing banks and does not depend on Allpay.

Subscriptions are recurring charges from the customer’s card without the need to re-enter card details. In Hebrew, this is called "Oraat Keva", which literally means "standing instruction".

Activate the subscriptions module in the <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Modules</span> section.

Creating a subscription

<span class="u-richtext-counter">1</span> When creating a payment link, clock "More" button to expand settings section and change payment type to “Subscription”.

<span class="u-richtext-counter">2</span> Specify when the subscription should start and end, then click the “Create Link” button.

<span class="u-richtext-counter">3</span> Once the customer subscribes using this link, the subscription will appear on the main screen under the “Subs” (Subscriptions) menu.

Subscription start options

Immediately — the first charge will occur at the moment the subscription is created, and then recur on the same day each month.

‍In N days — the first charge will occur after the specified number of days from the subscription start date, and then continue monthly on that same day.“Date” — the first charge will occur on the selected date. If the selected date is in the past, the subscription cannot be created.

‍Day of month — the first charge will occur on the specified day of the month and repeat monthly on that same day. If the selected day matches the subscription start date, the charge will happen immediately. If the 30th or 31st is selected but the month doesn’t have that date, the charge will occur on the last day of the month (e.g., February 28th).

Date — the first charge will occur on the selected date. If the selected date is in the past, the subscription cannot be created.

Subscription end options

No end date — charges will continue until the subscription is manually canceled in the dashboard.

Date — charges will continue until the selected date. For example, if the end date is set to August 15, 2030, and charges occur on the 16th of each month, the last charge will take place on July 15, 2030, and there will be no charge in August.

After N charges — the subscription will end after the specified number of charges. For example, to create a one-year subscription, set it to 12.

Subscription statuses

<span class="u-richtext-element" style="background-color: rgba(68, 203, 138, 0.5)">Active</span> — charges are being processed successfully.

<span class="u-richtext-element" style="background-color: rgba(113, 124, 144, 0.2)">Completed</span> — all scheduled charges have been successfully processed.

<span class="u-richtext-element" style="background-color: rgba(242, 201, 76, 0.8)">Cancelled</span> — you manually cancelled the subscription charges.

<span class="u-richtext-element" style="background-color: rgba(221, 94, 94, 0.4)">Failed</span> — a charge attempt failed; the system will make up to 6 more retry attempts.

Tracking subscriptions

Charges from subscriptions appear in two sections:

1. On the main payments screen, alongside other payments;
2. In the “Subs” section, where you can view the full charge schedule for each subscription.

Notifications about subscription charges are sent by email and Telegram — just like regular payments — if the notification option is enabled in <span class="u-richtext-element">Settings</span> ➙ <span class="u-richtext-element">Notifications</span>.

Cancelling a subscription

In the settings of the desired subscription, select “Cancel subscription”. The customer will receive an email notification that their subscription has been cancelled.

It is not possible to resume charges on a cancelled subscription. The customer will need to re-subscribe.

Failed charge

A scheduled subscription charge may fail if the card has insufficient funds, the credit limit is exceeded, the card has expired, or it has been cancelled.

If a charge fails, the system will automatically make up to 6 more attempts — one per day. If all attempts fail, the subscription will remain in “Failed” status, and the charge history will include a note: “Subscription stopped”.

In the subscription management menu, a “Retry charge” option will appear, allowing you to manually initiate a new charge. Before retrying, we recommend checking with the customer to make sure their card is working properly.

If, when setting up a subscription with the first charge set to “Immediately”, the first charge attempt fails, for example because the card has insufficient funds, the subscription will still be created with the “Failed” status. The system will then automatically schedule a retry attempt.

Subscriptions vs installments

Since installment payments work only with Israeli credit cards, some businesses use subscriptions to collect payments from international customers in multiple parts.

It’s important to understand the difference: With installments you are guaranteed to receive the full amount — even if the customer’s card has insufficient balance on future dates. With subscriptions, each charge is a separate transaction, and if the card has no funds at the time of billing, the charge will fail.

After a customer completes a payment, the funds are automatically transferred to your bank account. This process is called a payout.

There is no need to manually request transfers — Allpay automatically processes payouts according to the selected schedule.

Standard payout schedule

By default, payouts are made once per month.

All payments received during a calendar month are transferred on the 6th day of the following month. This option works well for most businesses, especially when daily transfers are not required.

The payout schedule is always available in your Allpay dashboard.

Weekly payouts

If you need to receive funds more frequently, you can activate the weekly payout option.

In this case, funds are transferred every week. An additional commission applies for this option.

What is deducted from payouts

Payouts are made after deducting the payment provider commission and VAT.

In your dashboard, you can see transaction history, payout amounts, and detailed calculations.

Allpay provides a transparent and predictable payout process so you can better manage your business cash flow.

Read the detailed article about payouts.