Справка

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

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

Поля ввода для номера карты, даты истечения и 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> и пропишите домены, на которых будет размещен iFrame и при необходимости адаптируйте стили CSS.

<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>Также на странице оплаты разместите слудющий скрипт:

<script src="https://allpay.to/js/allpay-hf.js"></script>
    <script>
    let Allpay = new AllpayPayment(
        {
            iframeId: 'iframe_id',
            onSuccess: function() { alert('Payment success'); },
            onError: function(error_n, error_msg) { alert('Payment error: ' + error_n + ' (' + error_msg + ')'); }
        }
    );
    </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>

Кнопка 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».

НДС 0% может применяться к продажам иностранным резидентам.

Согласно закону, иностранным резидентом считается физическое лицо, постоянно проживающее за пределами Израиля, или юридическое лицо, зарегистрированное за границей.

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

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

Автоматическая установка НДС 0%

Если бизнес желает, чтобы НДС 0% в квитанциях устанавливался автоматически, относительно надежный способ — полагаться на страну, в которой была выдана карта плательщика (с оговоркой, что этот способ также имеет исключения).

Поэтому Allpay имеет функцию создания квитанций с НДС 0% для оплат, совершенных иностранными картами. При этом по техническим причинам система может определить, была ли оплата сделана иностранной картой, только после фактической оплаты.

Так как налоговая квитанция (хэшбонит мас/кабала) создается после фактической оплаты, система укажет в квитанции 0% НДС, а стоимость услуги будет равна итоговой стоимости.

Пример:

Оплата израильской картой:

Услуга — 100 шек.

НДС — 17 шек.

Итого — 117 шек.

Оплата зарубежной картой:

Услуга — 117 шек.

НДС — 0 шек.

Итого — 117 шек.

Рекомендуем в <span class="u-richtext-element">Настройках</span> → <span class="u-richtext-element">Компания</span> установить «НДС включен в цену» и выставлять цены уже с учетом НДС. Так для зарубежных клиентов это будет выглядеть более естественно.

Взимание НДС по зарубежным картам

Если бизнес не желает полагаться на определение иностранного резидентства по стране карты, в <span class="u-richtext-element">Настройках</span> → <span class="u-richtext-element">Компания</span> необходимо активировать чекбокс <span class="u-richtext-element">Взимать НДС по зарубежным картам</span>, и тогда НДС будет взиматься с зарубежных карт наравне с израильскими.

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

Это касается платежных ссылок, созданных через 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>»

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

‍

Strong Customer Authentication (SCA) — это обязательное требование Европейского Союза, направленное на повышение безопасности платежей. Оно требует, чтобы пользователи подтверждали онлайн-платежи с использованием как минимум двух из трех независимых факторов аутентификации:

1. Что-то, что он знает → пароль, PIN-код.
2. Что-то, что у него есть → телефон, банковская карта, токен.
3. Что-то, чем он является → биометрия (отпечаток пальца, Face ID, голос).

Это значит, что простой ввод пароля или кода из SMS не считается достаточной аутентификацией, если он не сопровождается вторым фактором.

3D Secure как часть SCA

3D Secure (3DS) — это технология, разработанная для защиты онлайн-платежей. Она позволяет банкам запрашивать дополнительную аутентификацию клиента при оплате картой в интернете.

С 3DS банк может запрашивать два фактора аутентификации, например:

• SMS-код + пароль интернет-банка.
• Push-уведомление в банковском приложении + биометрия.
• Face ID / Touch ID через приложение банка.

Как Apple Pay выполняет SCA

Apple Pay автоматически соответствует SCA, потому что использует:

1. Биометрию (Face ID, Touch ID) → фактор «что-то, чем вы являетесь».
2. Устройство (iPhone, Apple Watch) → фактор «что-то, что у вас есть».

При оплате через Apple Pay аутентификация происходит на уровне устройства, поэтому дополнительное подтверждение через 3DS обычно не требуется.

‍

3DS — это технология, которая добавляет уровень безопасности для онлайн-платежей, требуя от владельца карты подтвердить платеж в приложении банка или путем ввода одноразового SMS-кода.

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

3D Secure явялется частью требования по двухфакторной аутентификации клиентов Strong Customer Authentication при совершении онлайн платежей.

Подключение и настройка

Активировать 3DS и установить минимальную сумму платежа, от которой он будет применяться, можно в разделе <span class="u-richtext-element">Настройки</span> ➙ <span class="u-richtext-element">Модули</span> ➙ <span class="u-richtext-element">3DS</span>.

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

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

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

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

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

Для этого в разделе<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.

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

Для интеграций по API

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

Список тестовых карт можно найти в документации API.

Для платежных ссылок

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

Активировать его можно в разделе <span class="u-richtext-element">Настройки</span> --><span class="u-richtext-element">Платежные ссылки</span> --> <span class="u-richtext-element">Тестовый режим.</span>

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

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