Help Center

A J5 transaction is a two-step payment process that begins with a pre-authorization. In the first step, the specified amount is reserved (held) on the buyer’s card for up to 168 hours (7 days) without actually charging the card.

To charge the reserved funds, the seller must initiate a charge request within that time frame and within the reserved amount. If the charge is for a smaller amount, the remaining balance is automatically released.

The term “J5” is used in Israeli payment systems as an internal code to refer to this type of transaction.

Use Cases

Delivery orders – The amount is reserved when the order is placed and charged after delivery is confirmed.

Variable price orders – For example, when buying products sold by weight (meat, fruits, vegetables), the final price is determined after weighing.

‍Pay as you go – The customer uses a service within a limit, and the final amount is calculated at the end.

Car rentals & hotels – The amount is reserved to cover possible damages or extra expenses.

Custom-made products – When ordering custom furniture or jewelry, the amount is reserved at checkout and charged when the product is ready.

Limitations

The charged amount cannot exceed the reserved amount.

Charging is allowed only once. Any attempt to charge again or after 168 hours will result in an error.

Supported Payment Methods

Both Israeli and international credit and debit cards are supported.

Express payment methods (Apple Pay, Google Pay, Bit) are not supported for J5. These buttons will be hidden on the authorization page.

How to Use

J5 functionality is available to developers via the Allpay API: view API documentation.

Demo

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

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

Рассрочка работает только по кредитным картам, выпущенным в Израиле!

1. Создайте ссылку на оплату

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

2. Отправьте ссылку клиенту

На странице оплаты клиент увидит опцию выбора числа платежей. Если он оставит 1 платеж, то полная сумма будет списана сразу.

Пример

Для услуги стоимостью 6000₪ вы открыли возможность рассрочки до 5 платежей. При оплате клиент выбрал рассрочку в 3 платежа. В момент оплаты с него будет списана сумма 2000₪, через месяц еще 2000₪ и на третий месяц последние 2000₪.

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

Если оплата в рассрочку не прошла

Наиболее вероятные причины:

1) карта клиента не является кредитной, а дебетовой;

2) карта выпущена не израильским банком;

3) кредитный лимит карты (мисгерет) меньше общей суммы платежа.

Почему невозможна рассрочка по иностранным картам

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

Это ограничение финансовой системы. Рассрочка по сути — это кредит. Если у клиента нет денег на счёте, то вы (как бизнес, которому он сделал оплату в рассрочку) всё равно получаете очередной платёж за счёт кредита, который банк даёт клиенту. Управление кредитным лимитом для граждан и взыскание с них долга в случае непогашения кредита можно гарантировать только внутри страны.

Если клиент отменил карту

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

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

Коды ошибок

20004 Refusal by credit company. Please try a different card

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

20010 Payment is not approved for debit cards

Попытка осуществить платеж в рассрочку по дебетовой карте. Такие платежи возможны только по кредитным картам и только выпущенным в Израиле. Больше информации.

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, система конвертирует рубли в шекели и спишет с карты клиента шекели.