Справка

Найдено 100 из 200

Почему клиент видит два списания после оплаты

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

Как работает процесс оплаты

Каждая оплата картой проходит в два этапа:

Авторизация (pending / ожидание)
Банк временно блокирует сумму на карте клиента. В приложении или выписке это отображается как отдельная операция. Средства ещё не списаны, а только зарезервированы.
Списание (capture / окончательное списание)
После подтверждения транзакции деньги списываются окончательно.

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

Почему так происходит

Отображение операций зависит от банка-эмитента карты и от типа карты.

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

Что сказать клиенту

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

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

Ошибки

Аналитика на странице оплаты через Google Tag Manager

Данный инструмент в разработке. О появлении будет объявлено в Telegram-канале.

Google Tag Manager (GTM) — это бесплатный инструмент от Google, который позволяет добавить на платёжную страницу аналитику и сторонние скрипты (теги) без необходимости менять код вручную.

С помощью GTM вы можете быстро подключать и управлять такими инструментами, как:

Google Analytics
Meta Pixel (Facebook)
TikTok Pixel
Hotjar
Чат-виджеты
Рекламные конверсии и события

Всё это можно делать через один интерфейс GTM без участия разработчика.

Таким образом вы можете отслеживать как аналитику, так и путь клиента с вашего сайта на страницу оплаты Allpay и обратно.

‍

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

Интеграции

Аналитика

Отображение суммы в валюте (USD, EUR и др.) вместо шекеля

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

Чтобы сумма на странице оплаты отображалась, например, в долларах (USD) или евро (EUR), необходимо перейти в Настройки ➙ Платежные ссылки и активировать переключатель «Мультивалютный формат цены». Затем в выпадающем списке выбрать нужные валюты.

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

Это не валюта платежа, а формат отображения суммы на странице оплаты. Транзакция пройдет в шекелях по текущему курсу и квитанция будет создана в шекелях. Источник курсов валют: Google Finance.

Курс рассчитывается в момент открытия клиентом ссылки на оплату.

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

Если необходимо, чтобы оплата поступала в валюте, а не в шекелях, читайте статью Прием платежей в валюте.‍

Нехватает валюты?

Если в списке нет нужной валюты, напишите в поддержку.

Интеграции

В запросе на оплату, который поступает с вашего сайта, содержатся два параметра: валюта и сумма платежа. Например, если валюта — RUB, на кнопке оплаты будет отображаться сумма в двух валютах: рублях и шекелях. Система сконвертирует рубли в шекели и спишет с карты клиента сумму в шекелях.

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

Подписки (рекуррентные платежи)

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

Активируйте модуль подписок в разделе Настройки --> Модули.

Обзор модуля подписок

‍

Создание подписки

1 При создании платежной ссылки разверните раздел «Дополнительно» и измените тип платежа на «Подписка».

2 Укажите, когда подписка должна быть начата и завершена и нажмите на кнопку «Создать ссылку».

3 Когда клиент оформит подписку по данной ссылке, она появится на главном экране в меню «Подписки».

Опции начала подписки

‍«Сразу» — первое списание произойдет в момент оформления подписки, а затем — в этот же день каждого месяца.

‍«День месяца» — первое списание произойдет в указанное число месяца и будет повторяться ежемесячно в этот день. Если указанное число совпадает с датой оформления подписки, списание произойдет сразу. Если выбрано 30 или 31 число, а в месяце его нет, списание пройдет в последний день месяца (например, в феврале — 28-го).‍

«Через N дней» — первое списание произойдет через указанное количество дней после оформления подписки и затем продолжится ежемесячно в этот же день.

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

Опции завершения подписки

«Бессрочно» — списания будут продолжаться, пока подписка не будет отменена через личный кабинет.

‍«После N списаний» — подписка завершится после указанного количества списаний. Например, для подписки на год установите 12.

‍«Дата» — списания будут продолжаться до выбранной даты. Если указана дата 15 августа 2030 года, а списания происходят 16-го числа каждого месяца, последнее списание пройдет 15 июля 2030 года, а в августе уже не случится.

Статусы подписок

Активна — списания идут успешно.

Завершена — все списания успешно прошли.

Отменена — вы отменили списания по подписке.

Ошибка — списание не удалось, система сделает ещё 6 попыток.

Отслеживание подписок

Списания по подпискам отражаются в двух разделах: 1) на главном экране платежей наряду с другими платежами; 2) в разделе «Подписки», где можно видеть график списаний по конкретной подписке.

Уведомления о списаниях по подпискам направляются по e-mail и в Telegram, как и для обычных платежей, если в разделе Настройки ➙ Уведомления активирована опция уведомлений.

Отмена подписки

В настройках нужной подписки выберите «Отменить подписку». Клиент получит е-мейл уведомление, что его подписка была отменена.

Нет возможности возобновить списания по отмененной подписке. Клиенту потребуется оформить подписку заново.

Ошибка списания

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

В случае неудачного списания система сделает ещё 6 попыток — по одной в день. Если все попытки окажутся неудачными, то у подписки сохранится статус «Ошибка», а в истории списаний появится запись «Подписка остановлена».

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

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

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

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

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

Webhooks

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

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

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

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

Типы событий

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

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

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

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

Платёжная ссылка — в её настройках. В этом случае webhook будет отправляться при каждом платеже по этой ссылке.
API-интеграция — в настройках конкретной интеграции в разделе Интеграции по API. Это позволит получать webhook по всем платежам, прошедшим через данную интеграцию. Например, с вашим сайтом на Tilda, WordPress или другой платформой.

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

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

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

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

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

{
    "name": "Test payment",
    "items": "[{\"name\":\"Test payment\",\"price\":10,\"qty\":1}]",
    "amount": "10",
    "status": 1,
    "client_name": "Tanur Mikrogalov",
    "client_email": "test@allpay.co.il",
    "client_tehudat": "",
    "client_phone": "",
    "foreign_card": "0",
    "card_mask": "407517******9285",
    "card_brand": "visa",
    "receipt": "https:\/\/www.allpay.co.il\/receipt.pdf",
    "sign": "2367eefa04752fae489fc233670fce599be9083af8c9a581d4c7684ec33c0114"
}

‍

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

Параметр add_field

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

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

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

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

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

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

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

Удалите параметр sign из запроса.
Исключите параметры с пустыми значениями.
Отсортируйте оставшиеся ключи по алфавиту.
Из полученного списка возьмите значения параметров и объедините их в строку через символ «двоеточие» (:).
Добавьте в конец строки через «двоеточие» ваш Webhook secret key.
Примените к полученной строке алгоритм SHA256.
Сравните результат с параметром sign, переданным в запросе.

Платформы 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 будет отключён, чтобы предотвратить дальнейшие попытки отправки.

API

Интеграции

Передача параметров через URL платежной ссылки

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

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

К адресу платежной ссылки можно добавить параметры amount для суммы оплаты, client_name и client_email для данных клиента.

Например, https://allpay.to/~pay/dynamic?amount=100&client_name=Jason%20Statham&client_email=jason@go.com

Если параметры client_name и client_email не указаны, мы запросим эти данные у клиента при оплате.

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

Название товара

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

Параметры lang и client_tehudat

lang — язык страницы оплаты. Он определяется автоматически по языку браузера клиента, но вы можете изменить его, передав значения AR (арабский), EN (английский), HE (иврит) и RU (русский).

client_tehudat — номер теудат зеута, который передается в квитанцию об оплате. Чтобы скрыть это поле со страницы, передайте девять нулей.

Параметр add_field

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

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

В приведенном выше примере параметр add_field=any_text будет передан в URL редиректа после оплаты без изменений. Так вы можете отслеживать конверсию, переводить клиента на нужный этап воронки вашего чат-бота и выполнять иные необходимые действия после оплаты.

При необходимости, вы можете заложить в значение add_field строку с несколькими параметрами, разобрав их обратно на стороне вашего сервера. Например, add_field=par1-value1,par2-value2.

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

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

Создание платежных форм

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

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

Пример работы:

По этим ссылкам можно посмотреть исходные коды форм, использованных на видео:

https://allpay.to/demo/snippet-example-1.html

https://allpay.to/demo/snippet-example-2.html

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

‍

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

API

Hosted Fields: как встроить форму оплаты на сайт

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

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

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

Настройка

1 В разделе Настройки → Интеграции по API включите Hosted Fields для нужной интеграции.

2 Нажмите на кнопку Настройка Hosted Fields, адаптируйте стили CSS и укажите домены, на которых будет размещен iFrame. Домены вводятся через перенос строки. Поддомены необходимо добавлять отдельно или указывать в формате *.domain.com.

3 На странице оплаты вашего сайта разместите iFrame, задайте ему произвольный параметр id, а в параметре src укажите ссылку на оплату (payment_url), которую возвращает Allpay в ответ на запрос на создание платежа (см. раздел Payment request в документации API). Ссылки на оплату также можно генерировать через Allpay API Tester.‍

4 На странице оплаты разместите следующий скрипт:

1<script src="https://allpay.to/js/allpay-hf.js"></script>
2    <script>
3    let Allpay = new AllpayPayment(
4        {
5            iframeId: 'iframe_id',
6            onSuccess: function() { alert('Payment success'); },
7            onError: function(error_n, error_msg) { alert('Payment error: ' + error_n + ' (' + error_msg + ')'); }
8        }
9    );
10    </script>

‍

В скрипте замените следующие параметры на ваши:

iframeId — значение id вашего iFrame.
onSuccess — обработчик успешного завершения платежа (что должно произойти после успешной оплаты).
onError — обработчик ошибки платежа. Используя шаблон в скрипте, вы можете выводить текст ошибки оплаты.

5 Для запуска процесса выполните функцию Allpay.pay(). Например, назначив ее для кнопки «Pay»:

<button onclick="Allpay.pay();">Pay</button>

‍

Рассрочка

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

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

Кнопки Apple Pay и Bit не будут отображаться в предпросмотре и во фрейме, если они не активированы в разделе Настройки → Модули.

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

Кнопка Apple Pay

Чтобы кнопка Apple Pay работала корректно, задайте атрибут allow="payment *" в теге iframe. Пример:

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

‍

API

Прием платежей в валютах доллара и евро

Кроме шекеля Allpay поддерживает платежи в долларах и евро.

В разделе Настройки ➙ Разрешения отображаются доступные вам валюты платежей.

После регистрации разрешен прием платежей в шекелях. Для получения оплат в долларах (USD) или евро (EUR) необходимо запросить отдельное разрешение.

Прежде чем просить разрешение на платежи в валюте

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

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

Подробнее об этой функции: Как отображать сумму платежа в USD или EUR.‍

Мы рекомендуем использовать это решение в большинстве случаев.

Получение разрешения на оплаты в валюте

Зайдите в Настройки ➙ Модули и активируйте модуль «USD & EUR».

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

На английском языке;
Содержать номер счета в формате IBAN;
Содержать ваше имя (или название компании) и номер теудат зеута (или номер компании).

Примеры справок для банков: Дисконт, Леуми, Апоалим.

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

Справка будет передана в соответствующую кредитную организацию (Isracard или CAL — в зависимости от способа подключения вашего бизнеса в системе Allpay) с просьбой об одобрении для вас разрешения на операции в валюте. Средний срок выдачи разрешения — 2-3 недели.

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

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

Когда разрешение выдано, статус модуля изменится на «Активен», и вам будет направлено уведомление. Убедитесь, что уведомления активированы в разделе Настройки ➙ Уведомления.

Как принимать платежи в валюте

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

При создании платежей по API вы сможете передавать значения"USD" или "EUR" в параметре currency.

Комиссия и выплаты

Мы не взимаем дополнительной комиссии за платежи в валюте, то есть применяются стандартные тарифы.

Однако ваш банк может взимать комиссию за зачисление валютных выплат. Такие выплаты осуществляются через систему SWIFT и проходят через цепочку из трех банков: наш банк, филиал вашего банка за рубежом и ваш банк в Израиле. Общая сумма комиссий за одну выплату может достигать $40. Мы не можем влиять на эту комиссию, но вы можете попросить у своего банка более выгодные условия.

По этой причине выплаты производятся от 100 USD/EUR. Сумма ниже 100 USD/EUR будет перенесена на следующую выплату.

Квитанции

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

Если вашему клиенту требуется квитанция с общей суммой в валюте платежа (а не в шекелях), ее можно скачать в виде копии в личном кабинете EasyCount или Morning.

Аккаунт

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

Документы

No results found.

Thank you! Your submission has been received!

Oops! Something went wrong while submitting the form.

Ответы на вопросы

Найдено 100 из 200

Text Link

Как часто происходят выплаты?

Платежи за месяц выплачиваются 6 числа следующего месяца. Также доступна опция еженедельных выплат. Больше информации о выплатах.

Text Link

Будут ли иные расходы?

Вот иные расходы, которые можно ожидать:

1. Электронные квитанции подключаются в виде стороннего сервиса, который стоит от 17 шек/месяц.

2. Комиссия за выплаты (вывод средств на ваш банковский счет) на сумму до 5000 ILS составит 17.58 ILS (включая НДС). Для выплат в долларах и евро банки могут взимать комиссию около 30 USD.

Text Link