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

Эта функция позволяет по 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> не указаны, мы запросим эти данные у клиента при оплате.

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

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

<span class="u-richtext-element">amount</span> — сумма платежа.

<span class="u-richtext-element">client_name</span> — имя клиента.

<span class="u-richtext-element">client_email</span> — email клиента.

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

<span class="u-richtext-element">currency</span> — валюта платежа. Например, ILS, USD, EUR. Если валюта не одобрена для аккаунта, то она будет сконвертирована в ILS.

<span class="u-richtext-element">currency_display</span> — валюта отображения. Например, можно показать цену в USD, а списать в ILS по текущему курсу. Список поддерживаемых валют отображения.‍

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

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

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

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

‍