Help Center

Транзакция J5 — это процесс оплаты, состоящий из двух этапов, который начинается с предварительной авторизации. На первом этапе указанная сумма резервируется на карте покупателя сроком до 168 часов (7 дней), без фактического списания средств.

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

Термин «J5» используется в израильских платёжных системах как внутренний код для обозначения этого типа транзакций.

Примеры применения

Доставка — сумма резервируется при оформлении заказа, списание происходит после успешной доставки.

Меняющаяся сумма — заказ весовых товаров (мясо, фрукты, овощи), когда итоговая сумма известна только после взвешивания.

Pay as you go — клиент пользуется сервисом в рамках лимита, и итоговая сумма определяется после окончания использования.

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

Изготовление товаров на заказ — при оформлении заказа на изготовление мебели или ювелирных изделий сумма резервируется, а списание происходит после готовности товара.

Ограничения

Сумма списания не должна превышать зарезервированную сумму.

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

Методы оплаты

Поддерживаются как израильские, так и зарубежные кредитные и дебетовые карты.

Методы быстрой оплаты, такие как Apple Pay, Google Pay и Bit, не поддерживаются. Поэтому кнопки быстрой оплаты будут скрыты на странице авторизации платежа.

Как пользоваться

Функционал J5 доступен для разработчиков через API-интерфейс Allpay. Открыть документацию API.

‍

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

Коды ошибок

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

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".