Справка

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

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

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

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

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

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

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

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

Отображение суммы в разных валютах

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

Важно понимать: это визуальное отображение. Фактически приём средств происходит в шекелях по текущему курсу.

Приём платежей в долларах и евро без конвертации

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

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

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

Поддерживаемые способы оплаты

Allpay поддерживает основные международные платёжные бренды:

• Visa
• Mastercard
• American Express
• Diners
• и другие

Также доступны методы быстрой оплаты:

• Apple Pay
• Google Pay
• Bit

При оплате через Bit клиенту не нужно вводить номер телефона. Он нажимает кнопку Bit на странице оплаты и подтверждает транзакцию в приложении Bit на своём телефоне.

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

Allpay предлагает два способа принимать онлайн-платежи: через платёжные ссылки и через подключение платёжной системы к вашему сайту.

Вы можете использовать любой из этих способов — или оба одновременно.

Платёжные ссылки

Платёжные ссылки — это самый простой и распространённый способ начать принимать оплату.

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

Далее вы можете отправить эту ссылку клиенту через WhatsApp, Instagram, Facebook или любой мессенджер. Клиент открывает ссылку и оплачивает заказ:

• вводит данные банковской карты
• или выбирает Apple Pay или Google Pay
• или оплачивает через Bit

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

Все платежи отображаются в реальном времени в личном кабинете Allpay.

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

Подключение к сайту или интернет-магазину

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

На сайте Allpay есть раздел «Интеграции», где перечислены популярные платформы для создания интернет-магазинов с пошаговыми инструкциями по подключению.

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

Allpay поддерживает распространённые платформы, включая:

• Shopify
• WordPress
• Tilda
• и другие

Также вы можете подключить Allpay к сайтам, созданным на no-code и AI-платформах, включая решения для вайбкодинга, такие как Lovable и аналогичные сервисы. В большинстве случаев подключение можно выполнить без глубоких технических знаний, используя готовые инструкции или стандартные способы интеграции.

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

Какой способ выбрать?

Вы сами решаете, какой вариант использовать:

• только платёжные ссылки
• только интеграцию с сайтом
• или оба способа одновременно

Allpay позволяет гибко настроить приём онлайн-платежей под формат вашего бизнеса.