Справка

Транзакция 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

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

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

Е-мейл уведомление само по себе не является квитанцией.

‍
Если вы подключите интеграцию с системой электронных квитанций EasyCount, квитанция будет создаваться автоматически, а в уведомление будет добавлена кнопка для её скачивания.

Пример е-мейл уведомления

Платежи, полученные в течение месяца, автоматически выплачиваются 6-го числа следующего месяца. Может занять до трёх рабочих дней, прежде чем выплата отразится на вашем банковском счёте.

Минимальная сумма выплаты составляет 100 ILS, USD или EUR.

Схема работы

После совершения платежа в течение 3-5 дней он обрабатывается кредитной организацией и затем включается в ближайшую выплату. Дату выплаты каждого платежа можно посмотреть в его свойствах, нажав на иконку «глазика».

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

Исключение

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

Например, платеж от 30 июля будет считаться проведенным в августе и соответственно выплачен 6-го сентября.

Как отслеживать выплаты

График выплат доступен на вкладке «Выплаты» на главном экране. Нажав на выплату, можно увидеть список платежей, которые в нее вошли.

Чтобы получать уведомления о выплатах на электронную почту или в Телеграм, активируйте их в разделе <span class="u-richtext-element">Настройки</span> ➙ <span class="u-richtext-element">Уведомления</span>

Ваш банковский счёт для выплат указан в разделе <span class="u-richtext-element">Настройки</span> ➙ <span class="u-richtext-element">Выплаты</span>.

Комиссия

Кредитная организация взимает комиссию в размере 17.43 шек (включая НДС) с каждой выплаты на сумму менее 5000 шек.

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

Управление выплатами

Настроить режим выплат можно в разделе <span class="u-richtext-element">Настройки</span> ➙ <span class="u-richtext-element">Выплаты</span>

1) Автоматические выплаты 6 и 12 числа. Будут выплачены средства, доступные на этот день. Например, если включить только 6 число, то средства, доступные к выплате 12-го, будут перенесены на следующее 6 число.

2) Автоматически по достижению N суммы. Средства, доступные к выплатам 6 и 12 числа, будут накапливаться и выплатятся автоматически, когда сумма достигнет указанного значения.

3) Выводить средства вручную. Автоматические выплаты будут отключены. Каждого 6-го и 12-го средства будут накапливаться и ждать, когда вы нажмете на кнопку запроса выплаты на вкладке «Выплаты».

Возвраты

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

Разбивка и документы

Каждого 11-го числа на вкладке «Выплаты» появляется запись с двумя документами: 

1) Разбивка по всем платежам за месяц. Содержит информацию о размерах комиссии по всем платежам, прошедшим с 1 по 31 число предыдущего месяца.

2) Квитанция за комиссию. Подходит для бухгалтерской отчетности как подтверждение расхода.

Читайте также: Где скачать квитанцию за комиссию платежной системы

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

Данная функция в разработке. О ее появлении будет объявлено в 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 позволяют встроить поля ввода карты на ваш сайт или в приложение, полностью адаптируя их под дизайн системы. Они создают ощущение целостности интерфейса и исключают необходимость перенаправления клиента на внешнюю страницу оплаты. Это повышает удобство использования и конверсию.

Поля ввода для номера карты, даты истечения и CVC представляют собой iFrame. Мы даем возможность полностью кастомизировать их CSS и встроить на ваш сайт в виде единого фрейма.

Видеоинструкция

Настройка

<span class="u-richtext-counter">1</span> В разделе <span class="u-richtext-element">Настройки</span> → <span class="u-richtext-element">Интеграции по API</span> включите Hosted Fields для нужной интеграции.

<span class="u-richtext-counter">2</span> Нажмите на кнопку <span class="u-richtext-element">Настройка Hosted Fields</span>, адаптируйте стили CSS и укажите домены, на которых будет размещен iFrame. Домены вводятся через перенос строки. Поддомены необходимо добавлять отдельно или указывать в формате *.domain.com.

<span class="u-richtext-counter">3</span> На странице оплаты вашего сайта разместите iFrame, задайте ему произвольный параметр <span class="u-richtext-element">id</span>, а в параметре <span class="u-richtext-element">src</span> укажите ссылку на оплату (payment_url), которую возвращает Allpay в ответ на запрос на создание платежа (см. раздел Payment request в документации API). Ссылки на оплату также можно генерировать через Allpay API Tester.‍

<span class="u-richtext-counter">4</span> На странице оплаты разместите следующий скрипт:

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>

‍

В скрипте замените следующие параметры на ваши:

• <span class="u-richtext-element">iframeId</span> — значение id вашего iFrame.
• <span class="u-richtext-element">onSuccess</span> — обработчик успешного завершения платежа (что должно произойти после успешной оплаты).
• <span class="u-richtext-element">onError</span> — обработчик ошибки платежа. Используя шаблон в скрипте, вы можете выводить текст ошибки оплаты.

<span class="u-richtext-counter">5</span> Для запуска процесса выполните функцию <span class="u-richtext-element">Allpay.pay()</span>. Например, назначив ее для кнопки «Pay»:

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

‍

Рассрочка

Если при создании платежа вы включили для клиента опцию рассрочки, передав значение в параметре <span class="u-richtext-element">inst</span>, тогда во фрейме автоматически появится поле для выбора количества платежей.

Кнопки быстрой оплаты

Кнопки Apple Pay и Bit не будут отображаться в предпросмотре и во фрейме, если они не активированы в разделе <span class="u-richtext-element">Настройки</span> → <span class="u-richtext-element">Модули</span>.

Также кнопки не отображаются в тестовом режиме и в рабочем режиме для оплат с опциями рассрочки и подписки.

Для проверки запросов на создание платежа через API доступны два инстурмента: Allpay API Tester для инициирования платежей и API метка для просмотр содержимого инициированного запроса.

Allpay API Tester

С помощью Allpay API Tester вы можете выполнять запросы на создание и отмену платежей, создание подписок и другие операции как в рабочей, так и в тестовой среде, эмулируя запросы с вашего сервера.

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

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

Метка API

Каждая транзакция, выполненная через API, имеет метку <span class="u-richtext-element">API</span>. Нажав на неё, вы можете просмотреть связанные с ней заголовки и тело запросов и ответов.