Справка

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

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

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

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

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

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

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

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

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

Ограничения

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

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

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

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

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

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

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

‍Демонстрация

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

Если клиент выберет 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

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

Для проверки запросов на создание платежа через 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>. Нажав на неё, вы можете просмотреть связанные с ней заголовки и тело запросов и ответов.

Кнопка Apple Pay позволяет быстро оплачивать с помощью iPhone, Mac и других устройств Apple. Чтобы кнопка появилась на странице оплаты, необходимо активировать модуль в разделе <span class="u-richtext-element">Модули</span> --> <span class="u-richtext-element">Apple Pay</span>.

Кнопка отображается только когда страница оплаты открыта с устройства Apple с добавленным методом оплаты.

Исключения

Так как Apple Pay не разрешает сохранять данные карты для последующих списаний, кнопка будет скрываться

• на страницах оплаты с опцией рассрочки, если клиент выберет более одного платежа;
• на страницах оплаты типа «подписка».

Непрошедшие платежи с именем «Applepay Payer»

Apple Pay передаёт нам имя клиента только после успешной оплаты. Нажатие на кнопку Apple Pay инициирует процесс оплаты, и появляется транзакция с именем «Applepay Payer» и статусом «Неоплачен». Затем клиент подтверждает платёж на устройстве, Apple Pay проводит его и возвращает нам имя клиента, которое мы отображаем вместо «Applepay Payer», а статус транзакции меняется на «Оплачено успешно».

Однако если платёж не был подтверждён на устройстве или не был одобрен Apple Pay, имя клиента так и останется «Applepay Payer», и мы не увидим причину отказа.

В случаях, когда клиент переходит к оплате с вашего сайта, где он указал своё имя на этапе оформления заказа, мы отобразим его вместо «Applepay Payer».

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

Это касается платежных ссылок, созданных через Allpay. Если вы подключены через API, настройка полей выполняется на стороне вашего сайта.

Добавление полей ввода для платежных ссылок

‍1. Активация дополнительных полей ввода

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

2. Добавление полей

При создании платежной ссылки нажмите на <span class="u-richtext-element">Дополнительно</span>, а затем на <span class="u-richtext-element">Управление полями</span>. Добавьте необходимые поля и их названия и нажмите «Сохранить».

Добавленные поля будут доступны для ВСЕХ платежных ссылок.

3. Активация полей

Активируйте переключатель для тех полей, которые необходимо отображать на странице оплаты для ДАННОЙ КОНКРЕТНОЙ платежной ссылки.

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

4. После оплаты

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

Перевод названий полей

Для платежных ссылок на нескольких языках названия полей можно перевести.

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

Как вставить ссылку

В названиях полей ввода разрешены HTML-теги: <span class="u-richtext-element">a</span> для ссылок, <span class="u-richtext-element">b</span> для жирного текста, <span class="u-richtext-element">i</span> для курсива и <span class="u-richtext-element">span</span> для применения индивидуальных стилей.

Например, чтобы вставить ссылку в название поля типа «чекбокс», название должно выглядеть следующим образом:

Согласен с <a href="https://allpay.co.il/terms">условиями</a>

Результат будет выглядеть следующим образом:

«Согласен с <a href="https://allpay.co.il/terms">условиями</a>»

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

‍

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

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

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

Сокрытие поля для платежей по платежным ссылкам

Поле ввода теудат зеута и чекбокс «Я не гражданин Израиля» могут быть полностью скрыты со страницы оплаты. Это полезно тем, кто принимает оплаты только из-за рубежа.

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

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

Сокрытие поля для патежей по API

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

При создании платежной ссылки смените переключатель с «Я указываю сумму» на «Плательщик укажет сумму», укажите название товара или услуги.

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

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

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

Передача суммы через URL ссылки

Если в конце URL-адреса ссылки дописать <span class="u-richtext-element">?amount=СУММА</span>, то кнопки и поля ввода исчезнут и сумма станет фиксированной.

Например, https://allpay.to/~pay/dynamic?amount=300

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

В статье «Передача параметров через URL платежной ссылки» вы можете узнать о других возможностях передачи параметров через URL.

‍

‍