Справка

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

Сначала в личном кабинете Allpay необходимо создать платежную ссылку и установить ей тип <span class="u-richtext-element">Плательщик укажет сумму</span>.

К адресу платежной ссылки можно добавить параметры <span class="u-richtext-element">amount</span> для суммы оплаты, <span class="u-richtext-element">client_name</span> и <span class="u-richtext-element">client_email</span> для данных клиента.

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

Если параметры <span class="u-richtext-element">client_name</span> и <span class="u-richtext-element">client_email</span> не указаны, мы запросим эти данные у клиента при оплате.

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

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

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

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

<span class="u-richtext-element">lang</span> — язык страницы оплаты. Он определяется автоматически по языку браузера клиента, но вы можете изменить его, передав значения AR (арабский), EN (английский), HE (иврит) и RU (русский).

<span class="u-richtext-element">client_tehudat</span> — номер теудат зеута, который передается в квитанцию об оплате. Чтобы скрыть это поле со страницы, передайте девять нулей.

Параметр add_field

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

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

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

При необходимости, вы можете заложить в значение <span class="u-richtext-element">add_field</span> строку с несколькими параметрами, разобрав их обратно на стороне вашего сервера. Например, <span class="u-richtext-element">add_field=par1-value1,par2-value2</span>.

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

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

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

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

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

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

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

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

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

‍

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

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

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

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

Передача суммы через URL ссылки

Если в конце URL-адреса ссылки дописать <span class="u-richtext-element">?amount=СУММА</span>, то кнопки и поля ввода исчезнут и сумма станет фиксированной.

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

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

В статье «Передача параметров через URL платежной ссылки» вы можете узнать о других возможностях передачи параметров через URL.

‍

‍

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

Инструмент позволяет видеть JSON как самих запросов, так и возвращаемых ответов.

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

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

Требования для сайта

<span class="u-richtext-counter">1</span> Из содержимого сайта легко понять, что вы продаете.

<span class="u-richtext-counter">2</span> На сайте размещены контактные данные бизнеса:

• Телефон или WhatsApp, 
• Е-мейл,
• Адрес (город, улица, номер дома).

Если у бизнеса нет адреса, разместите тот, который указан в вашем свидетельстве о регистрации бизнеса (ишур эсек патур/мурше).

<span class="u-richtext-counter">3</span> Размещены Политика конфиденциальности и Условия оказания услуг/продажи товаров на английском или иврите.

Шаблон Политики конфиденциальности: ENG, HEB

Шаблон Условий (продажа товаров): ENG, HEB

Шаблон Условий (предоставление услуг): ENG‍

Шаблоны являются примерами. Allpay не дает юридических рекомендаций!

Сайт может быть на любом языке и в любой доменной зоне, однако Политика и Условия должны быть на английском или иврите.

<span class="u-richtext-counter">4</span> Если деятельность требует лицензирования, на сайте размещены соответствующие лицензии и сертификаты.

Требования для социальных сетей

<span class="u-richtext-counter">1</span> Из контента очевидно, что соцсеть используется для бизнеса и какие услуги или товары предлагаются.

<span class="u-richtext-counter">2</span> Страница содержит контактные данные: телефон, е-мейл и адрес (город, улица, номер дома), которые посетитель может легко увидеть.

Если не выполнить требования

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

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

‍

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

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

Автоматизируйте повторные попытки при неудачных списаниях

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

Рекомендуемый график: попытайтесь выполнить списание до 7 раз с интервалом в 1 день между каждой попыткой.

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

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

Предоставьте возможность ручного повторного списания

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

Это даст пользователям возможность самостоятельно устранить проблему после её решения (например, пополнив карту).

Убедитесь, что раздел с этой кнопкой остаётся доступным (не блокируется) при наличии неудачных списаний.

Отображайте возвраты в истории транзакций

Если был произведён возврат средств отобразите его в истории транзакций.

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

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

Позвольте привязать несколько карт

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

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

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

Обеспечьте лёгкий доступ к кнопке отписки

Сделайте кнопку отписки видимой и легко доступной.

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

Отображайте информацию о тарифе и начислениях

Предоставьте подробную информацию о начислениях непосредственно в интерфейсе.

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

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

Уведомления в реальном времени

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

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

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

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

Сокрытие поля теудат зеута

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

Для этого перейдите в <span class="u-richtext-element">Настройки</span> --> <span class="u-richtext-element">Платежные ссылки</span> и активируйте переключатель <span class="u-richtext-element">Скрывать поле ввода теудат зеута.</span>

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

Для разработчиков

Для передачи номера теудат зеута или сокрытия этого поля со страницы оплаты используйте параметр <span class="u-richtext-element">client_tehudat</span> согласно документации API.

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

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

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

Имя и е-мейл

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

Интеграции

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

API

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

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

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

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

Рассрочка работает только по кредитным картам, выпущенным в Израиле!

1. Создайте ссылку на оплату

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

2. Отправьте ссылку клиенту

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

Пример

Для услуги стоимостью 6000₪ вы открыли возможность рассрочки до 5 платежей. При оплате клиент выбрал рассрочку в 3 платежа. В момент оплаты с него будет списана сумма 2000₪, через месяц еще 2000₪ и на третий месяц последние 2000₪.

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

Если оплата в рассрочку не прошла

Наиболее вероятные причины:

1) карта клиента не является кредитной, а дебетовой;

2) карта выпущена не израильским банком;

3) кредитный лимит карты (мисгерет) меньше общей суммы платежа.

Почему невозможна рассрочка по иностранным картам

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

Это ограничение финансовой системы. Рассрочка по сути — это кредит. Если у клиента нет денег на счёте, то вы (как бизнес, которому он сделал оплату в рассрочку) всё равно получаете очередной платёж за счёт кредита, который банк даёт клиенту. Управление кредитным лимитом для граждан и взыскание с них долга в случае непогашения кредита можно гарантировать только внутри страны.