Справка

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

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

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

Кнопка Bit для зарубежных клиентов

Так как Bit — израильская система, мы даем возможность скрывать кнопку Bit для клиентов, которые платят из-за границы. Геолокацию клиента система определяет по его IP.

Соответствующий переключатель можно найти в настройках модуля.

Ограничения

До 5000 ILS. Платеж через Bit не может превышать 5000 шекелей. Сумма всех платежей в месяц от всех клиентов не может превышать 20 000 шекелей.

ILS. Bit поддерживает только оплату в шекелях.

Нет рассрочки. Через Bit можно оплатить только одним платежом.

Нет подписок. Bit не позволяет сохранять карту клиента для последующих списаний, поэтому мы скрываем кнопку Бита для платежных ссылок типа «Подписка».

Не платит с баланса. Списание происходит с карты, прикрепленной к Bit. Если на карте нет баланса или исчерпан кредитный лимит — платеж не пройдет.

9 минут. С момента нажатия на кнопку Bit у клиента есть 9 минут, чтобы совершить платеж.

Diners. Карты брендов Diners и Discover не поддерживаются Bit.

Имя и е-мейл

Bit не передает нам имя и e-mail плательщика, поэтому мы запрашиваем их самостоятельно при совершении платежа.

Поле e-mail является опциональным, и если не заполнено клиентом, подтверждение платежа не будет отправлено. Поле можно сделать обязательным в настройках модуля Bit.

Интеграции

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

API

Разработчики, осуществляющие интеграцию по документации, могут управлять отображением кнопки Bit на странице оплаты, задействуя параметр <span class="u-richtext-element">show_bit</span>. Однако сперва модуль Bit должен быть активирован через личный кабинет Allpay.

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

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

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

Установить дату и время для таймера можно в настройках платежной ссылки <span class="u-richtext-element">Дополнительно</span> → <span class="u-richtext-element">Таймер</span>.

Таймер всегда устанавливается по израильскому времени.

Если установить галку <span class="u-richtext-element">Показывать таймер на странице оплаты</span>, клиент увидит сколько осталось времени, чтобы совершить оплату.

После отключения ссылка получит метку <span class="u-richtext-element" style="background-color: rgba(221, 94, 94, 0.4)">Отключена</span>

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

Токен — это зашифрованное представление банковской карты клиента, которое хранится в платежной системе и позволяет списывать средства без повторного ввода данных карты.

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

Автоматические повторные попытки списания

Если платеж не прошел (например, из-за нехватки средств на карте), настройте автоматические повторные попытки.

Рекомендуется делать до 5-7 попыток, постепенно увеличивая интервал между ними: например, через 1 день, затем через 2, 3 и далее.

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

Возможность повторить платеж вручную

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

Если есть неудачные списания, этот раздел не должен блокироваться.

Возможность добавить резервную карту

Разрешите пользователю привязать вторую карту.

Сначала выполняйте списание с основной карты. Если не получилось — пробуйте резервную. Это снижает риск сбоев и прерывания сервиса.

Отображение возвратов

Если был сделан возврат, он должен отображаться в истории операций.

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

Простая отписка

Кнопка отмены подписки должна быть заметной и доступной.

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

Понятная информация о тарифе

В интерфейсе должна быть четко указана:

• стоимость подписки
• налоги
• комиссии
• итоговая сумма

Пользователь должен понимать из чего складывается платеж.

Уведомления

Сообщайте пользователю о важных событиях:

• неудачное списание
• успешное продление
• возврат средств

Уведомления можно отправлять по email или другим доступным способом, а также отображать в интерфейсе.

Webhook — это автоматическое уведомление о событии, отправляемое системой Allpay на внешний URL.

Когда происходит успешный платёж, Allpay направляет POST-запрос на указанный адрес. Запрос содержит всю информацию о платеже, включая имя покупателя, предмет платежа и сумму.

Разработчики и интеграторы используют webhook для:

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

Типы событий

В настоящее время в Allpay доступен webhook только для одного события — успешный платёж.

Для подписок webhook автоматически отправляется каждый месяц после успешного регулярного списания.

Где настроить webhook

Webhook настраивается отдельно для каждой платёжной ссылки или API-интеграции:

1. Платёжная ссылка — в её настройках. В этом случае webhook будет отправляться при каждом платеже по этой ссылке.
2. API-интеграция — в настройках конкретной интеграции в разделе <span class="u-richtext-element">Интеграции по API</span>. Это позволит получать webhook по всем платежам, прошедшим через данную интеграцию. Например, с вашим сайтом на Tilda, WordPress или другой платформой.

В Allpay нет централизованной настройки webhook для всех платежей — это сделано для гибкого управления уведомлениями по различным каналам.

Содержимое webhook-запроса

Allpay отправляет POST-запрос на указанный URL. Тело запроса — это JSON-объект с параметрами, относящимися к событию.

Примера запроса

POST /c96zv6ri852dvppncccdg6fxkjnpwojg HTTP/2
Host: hook.eu2.make.com
accept: */*
content-type:application/json
content-length: 453

{
    "name": "Consultation",
    "items": [
        {
            "name": "Consultation",
            "price": 150,
            "qty": 2,
            "vat": "1"
        },
        {
            "name": "Clock",
            "price": 50,
            "qty": 1,
            "vat": "1"
        }
    ],
    "amount": "350",
    "status": 1,
    "client_name": "Tanur Mikrogalov",
    "client_email": "test@email.com",
    "client_tehudat": "123456789",
    "client_phone": "+972 58 569 8877",
    "foreign_card": "0",
    "card_mask": "455743******3431",
    "card_brand": "visa",
    "receipt": "",
    "inst": 1,
    "sign": "83f6fab69f7b237ee2db5d9993b84b5fe89ef722af6206a0ffe64480501f3784"
}

‍

Каждый платёж, по которому отправлен webhook, получает соответствующую метку на главном экране платежей. Нажав на неё, можно просмотреть содержимое запроса.

Параметр add_field

Если в URL платёжной ссылки добавить <span class="u-richtext-element">?add_field=any-string</span>, этот параметр будет включён в тело запроса Webhook. Подробнее.

Безопасность webhook

Можно использовать два способа проверки достоверности webhook-запросов:

1. Проверка с помощью webhook secret key.
2. Проверка IP-адреса отправителя.

Проверка с помощью Webhook secret key

Для этого используется HMAC-подпись, основанная на алгоритме SHA256.

Алгоритм генерации подписи:

1. Удалите параметр <span class="u-richtext-element">sign</span> из запроса.
2. Исключите параметры с пустыми значениями.
3. Отсортируйте оставшиеся ключи по алфавиту.
4. Из полученного списка возьмите значения параметров и объедините их в строку через символ «двоеточие» (:).
5. Добавьте в конец строки через «двоеточие» ваш Webhook secret key.
6. Примените к полученной строке алгоритм SHA256.
7. Сравните результат с параметром <span class="u-richtext-element">sign</span>, переданным в запросе.

Платформы Make и Zapier позволяют реализовать такую проверку с помощью встроенных инструментов (например, скрипта в Code by Zapier).

Пример JavaScript для Zapier

const webhookKey = "YOUR WEBHOOK SECRET KEY";

// Parse the input params from JSON string to an object
const params = JSON.parse(inputData.params || '{}');

// Store the original signature from the request
const requestSignature = params.sign || null;

// Remove the 'sign' parameter before calculating the signature
delete params.sign;

function getApiSignature(params, webhookKey) {
    // Filter out empty values and sort keys alphabetically
    const sortedKeys = Object.keys(params)
        .filter((key) => {
            const value = params[key];
            return value !== null && value !== undefined && String(value).trim() !== '';
        })
        .sort();

    // Collect the values in sorted key order, process nested arrays (like "items")
    const chunks = [];
    sortedKeys.forEach(key => {
        const value = params[key];
        if (Array.isArray(value)) {
            value.forEach(item => {
                if (typeof item === 'object' && item !== null) {
                    Object.keys(item).sort().forEach(subKey => {
                        const val = item[subKey];
                        if (val !== null && val !== undefined && String(val).trim() !== '') {
                            chunks.push(String(val).trim());
                        }
                    });
                }
            });
        } else {
            chunks.push(String(value).trim());
        }
    });

    // Build the string to hash
    const baseString = chunks.join(':') + ':' + webhookKey;

    // Generate SHA256 hash
    const crypto = require('crypto');
    const hash = crypto.createHash('sha256').update(baseString).digest('hex');

    return { baseString, verifiedSignature: hash };
}

// Generate the signature
const result = getApiSignature(params, webhookKey);

// Return the original and calculated values
output = {
    requestSignature: requestSignature,
    baseString: result.baseString,
    verifiedSignature: result.verifiedSignature
};

‍

Пример проверки подписи в Zapier

‍

Проверка по IP-адресу

Более простой, но менее надежный способ — это проверять, что запрос поступил с IP-адреса сервера Allpay. IP-адрес можно запросить, обратившись в поддержку.

‍Повторные запросы и деактивация webhook

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

Если Allpay неоднократно сталкивается с ошибками при попытке доставки webhook-запроса, соответствующий webhook будет отключён, чтобы предотвратить дальнейшие попытки отправки.

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

Это позволяет полностью автоматизировать процесс оформления бухгалтерских документов.

Интеграция с бухгалтерскими сервисами

Allpay интегрирован с двумя лицензированными сервисами для создания бухгалтерских документов:

• EasyCount
• Morning

Оба сервиса одобрены Налоговым управлением Израиля и подходят для официальной бухгалтерской отчётности.

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

Как это работает

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

Вам не нужно выписывать документы вручную. В квитанцию автоматически передаются:

• имя клиента
• предмет оплаты
• сумма платежа
• способ оплаты
• другие данные транзакции

Тип документа (кабала или хешбонит мас/кабала) также определяется автоматически в зависимости от формы вашего бизнеса.

После оплаты клиент получает квитанцию на свой e-mail, а вы можете увидеть её в системе и скачать в любой момент.

Документы при возврате платежа

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

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

Собственная лицензия Allpay (скоро)

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

О запуске этой опции будет объявлено в официальном Telegram-канале Allpay.

Важно знать

EasyCount и Morning не являются частью Allpay. Allpay передаёт в эти сервисы данные для формирования документов.

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

После того как клиент оплачивает заказ, деньги автоматически переводятся на ваш банковский счёт. Этот процесс называется выплатой.

Allpay не требует вручную запрашивать перевод средств — система формирует выплаты автоматически по установленному графику.

Стандартный график выплат

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

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

График выплат всегда доступен в личном кабинете Allpay.

Еженедельные выплаты

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

В этом случае средства перечисляются каждую неделю. За такие выплаты взимается дополнительная комиссия.

Что учитывается при выплате

Выплаты производятся за вычетом комиссии и НДС.

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

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

Полная статья о выплатах: Выплаты

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

Логотип

Логотип компании добавляется в разделе <span class="u-richtext-element">Настройки</span> -> <span class="u-richtext-element">Компания</span>

Галерея изображений и видео

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

В настройках платежной ссылки активируйте блок <span class="u-richtext-element">Медиа</span> и загрузите изображения с вашего устройства или добавьте ссылку на YouTube.

<span id="text">Текстовый блок</span>

Блок <span class="u-richtext-element">Текст</span> позволяет добавить описание и перевести его на другие языки.

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

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

Если для какого-либо языка перевод не добавлен, будет использован текст из вкладки English. Поэтому не рекомендуем оставлять вкладку English пустой.

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

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

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

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

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

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

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