Справка

Эта функция позволяет по 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>.

Если для ссылки активирована отправка Webhook, то параметр <span class="u-richtext-element">add_field</span> будет включён в тело запроса.

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

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

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

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

Пример реализации:

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

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

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

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

‍

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

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

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

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

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

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

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

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

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

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

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

Чтобы сумма на странице оплаты отображалась, например, в долларах (USD) или евро (EUR), необходимо перейти в <span class="u-richtext-element">Настройки</span> ➙ <span class="u-richtext-element">Платежные ссылки</span> и активировать переключатель «Мультивалютный формат цены». Затем в выпадающем списке выбрать нужные валюты.

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

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

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

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

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

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

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

Интеграции

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

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

Е-мейл уведомление само по себе не является квитанцией.

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

Пример е-мейл уведомления

Транзакция J5 — это процесс оплаты, состоящий из двух этапов, который начинается с предварительной авторизации. На первом этапе указанная сумма резервируется на карте покупателя сроком до 168 часов (7 дней), без фактического списания средств.

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

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

Примеры применения

Доставка — сумма резервируется при оформлении заказа, списание происходит после успешной доставки.

Меняющаяся сумма — заказ весовых товаров (мясо, фрукты, овощи), когда итоговая сумма известна только после взвешивания.

Pay as you go — клиент пользуется сервисом в рамках лимита, и итоговая сумма определяется после окончания использования.

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

Изготовление товаров на заказ — при оформлении заказа на изготовление мебели или ювелирных изделий сумма резервируется, а списание происходит после готовности товара.

Ограничения

Сумма списания не должна превышать зарезервированную сумму.

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

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

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

Методы быстрой оплаты, такие как Apple Pay, Google Pay и Bit не поддерживаются. Поэтому кнопки быстрой оплаты будут скрыты на странице авторизации платежа.

Как пользоваться

Функционал J5 доступен для разработчиков через API-интерфейс Allpay. Открыть документацию API.

‍Демонстрация

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

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

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

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

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

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

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

Пример

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

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

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

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

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

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

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

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

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

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

Если клиент отменил карту

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

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

Коды ошибок

20004 Refusal by credit company. Please try a different card

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

20010 Payment is not approved for debit cards

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

Для проверки запросов на создание платежа через API доступны два инстурмента: Allpay API Tester для инициирования платежей и API метка для просмотр содержимого инициированного запроса.

Allpay API Tester

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

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

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

Метка API

Каждая транзакция, выполненная через API, имеет метку <span class="u-richtext-element">API</span>. Нажав на неё, вы можете просмотреть связанные с ней заголовки и тело запросов и ответов.