Help Center

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.

If you enable integration with the EasyCount electronic receipt system, the receipt will be created automatically, and a button for downloading it will be added to the notification.

Example of email notification

По умоланию сумма платежа с рассрочкой заходит ежемесячно в зависимости от числа платежей, которое было выбрано при оплате. Однако существует возможность получить полную сумму сразу.

Данная функция в разработке. О ее появлении будет объявлено в Telegram-канале.

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

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

Например, сумма была разбита на 5 платежей. В таком случае первый платеж вы получаете без дополнительной комиссии, а 2-5 платежи имеют комиссию. Так выплата второго платежа была ускоренная на 1 месяц, выплата второго платежа на 2 месяца и так далее.

Подписки — это рекуррентные (повторяющиеся) списания с карты клиента без необходимости повторного ввода данных карты. На иврите "ораат кева", что дословно переводится как "постоянное поручение".

Активируйте модуль подписок в разделе <span class="u-richtext-element">Настройки</span> --> <span class="u-richtext-element">Модули.</span>

Обзор модуля подписок

‍

Создание подписки

<span class="u-richtext-counter">1</span> При создании платежной ссылки разверните раздел «Дополнительно» и измените тип платежа на «Подписка».

<span class="u-richtext-counter">2</span> Укажите, когда подписка должна быть начата и завершена и нажмите на кнопку «Создать ссылку».

<span class="u-richtext-counter">3</span> Когда клиент оформит подписку по данной ссылке, она появится на главном экране на вкладке «Подписки».

Опции начала подписки

‍«Сразу» — первое списание произойдет в момент оформления подписки, а затем — в этот же день каждого месяца.

‍«День месяца» — первое списание произойдет в указанное число месяца и будет повторяться ежемесячно в этот день. Если указанное число совпадает с датой оформления подписки, списание произойдет сразу. Если выбрано 30 или 31 число, а в месяце его нет, списание пройдет в последний день месяца (например, в феврале — 28-го).‍

«Через N дней» — первое списание произойдет через указанное количество дней после оформления подписки и затем продолжится ежемесячно в этот же день.

‍«Дата» — первое списание пройдет в выбранную дату. Если указанная дата уже прошла, оформить подписку не получится.

Опции завершения подписки

«Бессрочно» — списания будут продолжаться, пока подписка не будет отменена через личный кабинет.

‍«После N списаний» — подписка завершится после указанного количества списаний. Например, для подписки на год установите 12.

‍«Дата» — списания будут продолжаться до выбранной даты. Если указана дата 15 августа 2030 года, а списания происходят 16-го числа каждого месяца, последнее списание пройдет 15 июля 2030 года, а в августе уже не состоится.

Статусы подписок

<span class="u-richtext-element" style="background-color: rgba(68, 203, 138, 0.5)">Активна</span> — списания идут успешно.

<span class="u-richtext-element" style="background-color: rgba(113, 124, 144, 0.2)">Завершена</span> — все списания успешно прошли.

<span class="u-richtext-element" style="background-color: rgba(242, 201, 76, 0.8)">Отменена</span> — вы отменили списания по подписке.

<span class="u-richtext-element" style="background-color: rgba(221, 94, 94, 0.4)">Ошибка</span> — списание не удалось, система сделает ещё 6 попыток.

Отслеживание подписок

Списания по подпискам отражаются в двух разделах: 1) на главном экране платежей наряду с другими платежами; 2) в разделе «Подписки», где можно видеть график списаний по конкретной подписке.

Уведомления о списаниях по подпискам направляются по e-mail и в Telegram, как и для обычных платежей, если в разделе <span class="u-richtext-element">Настройки</span> ➙ <span class="u-richtext-element">Уведомления</span> активирована опция уведомлений.

Отмена подписки

В настройках нужной подписки выберите «Отменить подписку». Клиент получит е-мейл уведомление, что его подписка была отменена.

В данный момент нет возможности возобновить списания по отмененной подписке. Клиенту потребуется оформить подписку заново.

Ошибка списания

Очередное списание по подписке может не пройти если, например, карта имеет недостаточный баланс или исчерпан кредитный лимит, истек срок действия карты или она была аннулирована.

В случае неудачного списания система сделает ещё 6 попыток — по одной в день. Если все попытки окажутся неудачными, то подписка получит статус «Подписка остановлена», а в меню управления подпиской появится опция «Повторить попытку списания», чтобы выполнить новое списание вручную.

Перед попыткой ручного списания рекомендуем уточнить у клиента, всё ли в порядке с его картой и достаточно ли средств на счёте.

Подписки не заменяют рассрочку

Так как рассрочка (ташлумим) работает только по израильским кредитным картам, некоторые клиенты используют подписки для получения оплаты от зарубежных клиентов с разбивкой на платежи.

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

Hosted Fields allow you to embed card input fields on your website or app, fully adapting them to the system's design. They create a seamless interface experience and eliminate the need to redirect the customer to an external payment page. This improves usability and conversion rates.

The input fields for the card number, expiration date, and CVC are represented as an iFrame. We provide the ability to fully customize their CSS and embed them on your site as a single frame.

Tutorial

Setup

<span class="u-richtext-counter">1</span> In the <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">API Integrations</span> section, enable Hosted Fields for the required integration.

<span class="u-richtext-counter">2</span> Click on the <span class="u-richtext-element">Hosted Fields Settings</span> button, customize the CSS styles, and specify the domains where the iFrame will be placed. Domains should be entered on separate lines. Subdomains must be added separately or specified in the format *.domain.com.

<span class="u-richtext-counter">3</span> On your website’s payment page, place an iFrame, assign any custom value to its <span class="u-richtext-element">id</span> parameter, and in the <span class="u-richtext-element">src</span> parameter specify the payment URL (payment_url) returned by Allpay in response to a payment creation request (see Payment request section in the API Reference). Payment URLs can also be generated using the Allpay API Tester.‍

<span class="u-richtext-counter">4</span> Add the following script to the payment page:

1<script src="https://allpay.to/js/allpay-hf.js"></script>
2    <script>
3    let Allpay = new AllpayPayment(
4        {
5            iframeId: 'iframe_id',
6            onSuccess: function() { alert('Payment success'); },
7            onError: function(error_n, error_msg) { alert('Payment error: ' + error_n + ' (' + error_msg + ')'); }
8        }
9    );
10    </script>

‍

In the script, replace the following parameters with your own:

• <span class="u-richtext-element">iframeId</span> — the id value of your iFrame.
• <span class="u-richtext-element">onSuccess</span> — the handler for successful payment completion (what should happen after successful payment).
• <span class="u-richtext-element">onError</span> — the handler for payment errors. For example, you can display the payment error message on the page.

<span class="u-richtext-counter">5</span> To initiate the process, execute the function <span class="u-richtext-element">Allpay.pay()</span>, for example, by assigning it to the "Pay" button:

<button onclick="Allpay.pay();">Pay</button>

Installments

If you enabled the installment option for the customer when creating the payment by passing a value in the <span class="u-richtext-element">inst</span> parameter, a field for selecting the number of payments will automatically appear in the frame.

Quick Pay Buttons

Apple Pay and Bit buttons will not be displayed in preview mode or within the iFrame if they are not activated in the <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Modules</span>.

Additionally, these buttons are not displayed in test mode. As well as in live mode for installment or subscription payments.

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

Чтобы сумма на странице оплаты отображалась, например, в долларах (USD) или евро (EUR), необходимо перейти в <span class="u-richtext-element">Настройки</span> ➙ <span class="u-richtext-element">Страница оплаты</span> и активировать переключатель «Мультивалютный формат цены». Затем в выпадающем списке выбрать нужные валюты.

Теперь при создании платежных ссылок под суммой появится переключатель валюты отображения. Если вы выберете USD, то сумма отобразится в двойном формате, например, 100 USD (350 ILS).

Это не валюта платежа, а формат отображения суммы на странице оплаты. Транзакция пройдет в шекелях по текущему курсу и квитанция будет создана в шекелях. Источник курсов валют: Google Finance.

Курс рассчитывается в момент открытия клиентом ссылки на оплату.

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

Если необходимо, чтобы оплата поступала в валюте, а не в шекелях, читайте статью Прием платежей в валюте.‍

Нехватает валюты?

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

Интеграции

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

Например, если ваш сайт отправляет запрос на оплату 1000 RUB, система конвертирует рубли в шекели и спишет с карты клиента шекели.

The Apple Pay button allows for quick payments using iPhone, Mac, and other Apple devices.

To make the button appear on the payment page, you need to activate the module in the <span class="u-richtext-element">Modules</span> --> <span class="u-richtext-element">Apple Pay</span>.

The button appears only when the payment page is opened on an Apple device with a saved payment method.

Exceptions

Since Apple Pay does not allow saving card details for future charges, the button will be hidden:

• on payment pages with an installment option if the customer selects more than one installment payment;
• on payment pages of the "subscription" type.

Unsuccessful payments with the name «Applepay Payer»

Apple Pay transmits the customer's name to us only after a successful payment. Pressing the Apple Pay button initiates the payment process, and a transaction appears with the name "Applepay Payer" and the status "Unpaid". The customer then confirms the payment on their device, Apple Pay processes it, and returns the customer's name to us, which we display instead of "Applepay Payer", while the transaction status changes to "Paid successfully".

However, if the payment was not confirmed on the device or was not approved by Apple Pay, the customer's name will remain "Applepay Payer", and we will not see the reason for the decline.

In cases where the customer proceeds to payment from your website and has entered their name at the checkout stage, we will display it instead of "Applepay Payer".

VAT 0% may apply to sales to foreign residents.

According to the law, a foreign resident is defined as an individual who permanently resides outside of Israel or a legal entity registered abroad.

When processing a payment, there is no reliable technical way to determine whether the payer is a foreign resident. Geolocation is unreliable, as an Israeli resident may be abroad at the time of payment.

Since the business is in direct contact with the customer to whom it sells goods or services and reports to the tax authorities, the business is responsible for correctly issuing the tax invoice.

Automatic application of VAT 0%

If a business wants VAT 0% to be automatically applied in invoices, a relatively good method is to rely on the country in which the payer’s card was issued (with the caveat that this method also has exceptions).

Therefore, Allpay provides a function to generate invoices with VAT 0% for payments made with foreign cards. However, for technical reasons, the system can only determine whether a payment was made with a foreign card after the transaction is completed.

Since the tax invoice (heshbonit mas/kabala) is generated after the actual payment, the system will indicate VAT 0% in the invoice, and the service cost will be equal to the final amount.

Example:

Payment with Israeli card:

Service — 100 NIS

VAT — 17 NIS

Total — 117 NIS

Payment with foreign card:‍

Service — 117 NIS

VAT — 0 NIS

Total — 117 NIS

We recommend setting <span class="u-richtext-element">VAT included in price</span> in <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Company</span> and displaying prices with VAT already included. This will appear more natural to international customers.

VAT collection for foreign cards

If a business does not want to rely on determining foreign residency based on the card’s country, it is necessary to activate the checkbox <span class="u-richtext-element">Charge VAT on foreign cards</span> in <span class="u-richtext-element">Settings</span> → <span class="u-richtext-element">Company</span>. This will apply VAT to foreign cards the same way as to Israeli cards.

You can request the customer's phone number, address, website, or other information by adding additional fields to the payment page.

This applies to payment links created through Allpay. If you are connected via the API, field setup is done on your website.

Adding input fields for payment links

1. Activating additional input fields  

Activate additional input fields in the <span class="u-richtext-element">Settings</span> ➙ <span class="u-richtext-element">Payment Links</span> section.  

2. Adding fields  

‍When creating a payment link, click <span class="u-richtext-element">Advanced</span>, then <span class="u-richtext-element">Manage Fields</span>. Add the required fields and their names, then click "Save".

The added fields will be available for ALL payment links.

3. Activating fields‍

Activate the toggle for the fields you want to display on the payment page for THIS SPECIFIC payment link.

If the field is also marked as required, the customer will not be able to proceed with the payment without filling it in.

4. After payment‍

The information entered by the customer is displayed in the transaction details on the main payment page. It is also included in payment notifications sent to Telegram, your email, and the customer.  

Field name translation

For payment links in multiple languages, field names can be translated.

In the <span class="u-richtext-element">Manage Fields</span> section, switch the language using the language selection menu and add a translation for each field.

How to insert a link  

HTML tags are allowed in input field names: <span class="u-richtext-element">a</span> for links, <span class="u-richtext-element">b</span> for bold text, <span class="u-richtext-element">i</span> for italics, and <span class="u-richtext-element">span</span> for applying custom styles.  For example, to insert a link into the name of a checkbox field, the name should look as follows:

Agree with <a href="https://allpay.co.il/terms">the terms</a>  

The result will look as follows:

«Agree with <a href="https://allpay.co.il/terms">the terms</a>»

Video tutorial