Справка

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

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

Если минимальное количество единиц установить равным 0 (нулю), клиент сможет исключить этот товар из оплаты.

Общее оставшееся количество отображается на плитке платежной ссылки. Когда наличие исчерпано (равно нулю), платежная ссылка автоматически отключится.

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

Одновременная покупка последнего товара

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

Например, если в наличии осталось 5 штук, и клиент А пытается купить все 5, а одновременно с ним клиент Б покупает 2 штуки и оплачивает первым, то клиент А увидит сообщение, что в наличии осталось только 3 штуки.

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

Коды ошибок

Refusal by credit company. Please try a different card (20004)

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

Payment is not approved for debit cards (20010)

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

Verification failed, please try again (21017)

Владелец карты не прошёл проверку 3DS: не ввёл код из SMS, не подтвердил платёж в приложении банка или не завершил проверку другим способом, предусмотренным банком.

1. Откройте эту ссылку в браузере Safari: Allpay App
2. В меню браузера нажмите "Поделиться" (Share) и затем "Добавить на домашний экран" (Add to Home screen).
3. Сохраните.

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

НДС

При переходе со статуса «эсек патур» на «эсек мурше» к платежам добавляется НДС.

Для всех ранее созданных платежных ссылок будет автоматически установлен НДС 18% в режиме «НДС включён». Итоговая сумма платежа при этом не изменится.

Это касается в том числе платежей по активным подпискам.

При переходе с «эсек мурше» на «эсек патур» НДС будет удалён из платежных ссылок:

• если ссылка работала в режиме «НДС включён», итоговая сумма платежа не изменится;
• если был выбран режим «НДС сверху», при котором НДС прибавлялся к указанной сумме, итоговая сумма платежа уменьшится на размер НДС.

Документы

Для «эсек мурше» вместо просто квитанции (קבלה) будет создаваться налоговая квитанция — хэшбонит мас/кабала (חשבונית מס/קבלה).

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

‍

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

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

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

Настройка

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

<span class="u-richtext-counter" id="domains">2</span> Нажмите кнопку <span class="u-richtext-element">Настройка Hosted Fields</span> и укажите домены, на которых будут использоваться Hosted Fields. Вводите каждый домен или поддомен с новой строки, без «https://», например: <span class="u-richtext-element">mysite.com</span>. Чтобы разрешить все поддомены, используйте маску со звёздочкой, например: <span class="u-richtext-element">*.mysite.com</span>.

При необходимости адаптируйте стили 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>

‍

Рассрочка

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

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

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

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

Кнопка Apple Pay

Чтобы кнопка Apple Pay работала корректно, задайте атрибут <span class="u-richtext-element">allow="payment *"</span> в теге <span class="u-richtext-element">iframe</span>. Пример:

<iframe id="myPaymentIframe" allow="payment *" src="..." >

Также на вашем сервере потребуется разместить сертификат Apple Pay. Чтобы получить его обратитесь в поддержку.

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

3DS без ввода кода (Frictionless 3DS)

Иногда 3DS-проверка проходит в фоновом режиме и не требует от клиента ввода SMS-кода или подтверждения в приложении банка.

Для проверки платёжная страница собирает техническую информацию об устройстве и браузере клиента: IP-адрес, тип браузера, язык, часовой пояс, параметры экрана и другие сведения. Эти данные передаются в рамках 3DS-проверки банку-эмитенту, который сопоставляет их с информацией о карте, сумме платежа, местоположении и истории операций. Если банк уверен, что платёж совершает настоящий владелец карты, он подтверждает 3DS без дополнительных вопросов.

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

Комиссия

За каждый платёж c 3DS взимается дополнительная комиссия согласно тарифу.

Комиссия списывается даже в случае неуспешного платежа — например, когда клиент подтвердил платеж с 3DS, но банк отклонил транзакцию.

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

Эта функция в разработке. О появлении будет объявлено в Телеграм-канале.

Каждый пользователь в системе Allpay имеет уникальный телефон, e-mail и ник Telegram. Невозможно привязать один и тот же Telegram, email или телефон к разным пользователям.

Вход в систему возможен только по подтверждённому контакту.

Добавление пользователей

Нажмите кнопку «+» на экране «Команда» и укажите имя, позицию в компании и хотя бы один контакт (e-mail, телефон или Telegram) — он будет использоваться для входа в Allpay.

Изменить данные пользователя можно в любой момент кнопкой «Редактировать» в его карточке.

Права доступа

Каждый пользователь получает доступ ко всем разделам, кроме раздела «Команда». Доступ к разделу «Команда» включается отдельно. Управлять правами может только владелец аккаунта.

Более детальное разделение прав будет введено позже.

Отключение пользователя

Переключатель «Аккаунт активен» в карточке пользователя мгновенно закрывает его доступ к вашему аккаунту. Отключить самого себя или владельца аккаунта нельзя.

Данные владельца

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

Подписки — это рекуррентные (повторяющиеся) списания с карты клиента без необходимости повторного ввода данных карты. На иврите "ораат кева", что дословно переводится как "постоянное поручение".

Активируйте модуль подписок в разделе <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 попыток — по одной в день. Если все попытки окажутся неудачными, то у подписки сохранится статус «Ошибка», а в истории списаний появится запись «Подписка остановлена». 

В меню управления такой подпиской появится опция «Повторить попытку списания», чтобы выполнить новое списание вручную. Перед попыткой такого списания рекомендуем уточнить у клиента, всё ли в порядке с картой.

Если при оформлении подписки с первым списанием «Сразу» первая попытка оплаты завершится ошибкой, например из-за недостатка средств на карте, подписка всё равно будет создана со статусом «Ошибка». После этого система автоматически запланирует повторную попытку списания.

Подписки не заменяют рассрочку

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

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

Лайфхак: разовое списание с отложенной датой

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

Для этого при создании подписки выберите опцию «Дата» или «Через N дней» и укажите, когда должно произойти первое списание. В настройках завершения выберите «После N списаний» и установите значение 1.

Клиент введёт данные карты сразу, а фактическое списание произойдёт в назначенную дату или через указанное количество дней. После единственного платежа подписка завершится автоматически — отменять её вручную не нужно.

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

При этом работают все стандартные механизмы подписок: клиент получает уведомление об оформлении, а если списание в назначенный день не удастся, система выполнит ещё шесть попыток — по одной в день.