Быстрый старт Документация API платёжной системы Allpay адаптирована для понимания AI-сервисами.
Достаточно создать новую интеграцию в Allpay, передать вашему AI-сервису API login и API key этой интеграции вместе со ссылкой на документацию API и попросить внедрить интеграцию строго в соответствии с документацией .
Подробная инструкция и примеры промптов приведены ниже.
Общие рекомендации Перед внедрением платежей убедитесь, что основной функционал сайта готов. Например, для интернет-магазина должны быть реализованы страницы товаров, оформление заказа, личный кабинет для отслеживания заказов, методы доставки и их стоимость, базовая логика расчёта итоговой суммы.
Сначала внедрите обычные платежи и полностью протестируйте их работу. Только после этого переходите к улучшениям: внедрению скидок, рассрочки, встроенной оплаты без редиректа и других функций.
Всегда просите AI выполнять одну задачу за раз. Не объединяйте несколько действий в одном промпте и не переходите к следующему шагу, пока предыдущий не завершён и не проверен.
Инструкция по интеграции платёжного API Allpay <span class="u-richtext-counter">1</span> В Allpay перейдите в раздел <span class="u-richtext-element">Настройки</span> → <span class="u-richtext-element">Интеграции</span> → <span class="u-richtext-element">Мои сайты</span>, укажите название вашей AI-платформы и создайте API login и API key.
<span class="u-richtext-counter">2</span> Найдите в вашей AI-платформе место для хранения секретов (переменных окружения).Обычно это раздел Secrets, Environment variables или Integrations. Создайте переменную, например с названием "Allpay" и укажите API key в качестве ее значения.
Вы можете спросить у самой платформы, куда именно следует сохранить API key, но не отправляйте ключ в чат в открытом виде. <span class="u-richtext-counter">3</span> Используйте следующий промпт для интеграции платежей. Вставьте в него ваш API login и название переменной, в которой хранится API key. При необходимости адаптируйте промпт под логику вашего проекта.
Шаблон промпта для интеграции API Allpay
Интегрируй платёжную систему Allpay строго в соответствии с официальной документацией API:
https: //www.allpay.co.il/api-reference
Обязательные правила
- Применяй документацию дословно, без интерпретаций.
- Не придумывай параметры, поля, переменные, преобразования или алгоритмы.
- Документация Allpay — единственный канонический и приоритетный источник истины.
Подпись запросов и вебхуков (критично)
- Используй строго тот алгоритм подписи, который описан в разделе Signature документации Allpay.
- Не описывай, не модифицируй и не оптимизируй алгоритм подписи.
Алгоритм применяется одинаково для:
- подписи запросов на создание платежа;
- проверки подписи webhook после успешного платежа.
Важное уточнение по данным webhook
- Проверка подписи webhook выполняется точно по тем данным, которые пришли от Allpay.
- Не делай выводов о типах данных (string / number / object) и не меняй алгоритм из-за этого.
- Если значения параметров приходят как числа, объекты или JSON -строки — обрабатывай их так, как предписывает документация, без самостоятельных «исправлений логики».
Запрещено:
- менять алгоритм подписи из-за типов данных;
- добавлять преобразования, не описанные в документации;
- делать предположения о внутренней реализации Allpay.
Приоритет документации
При любых моих последующих запросах, связанных с:
- платежами,
- статусами заказов,
- вебхуками,
- скидками,
- Hosted Fields,
- редирект-оплатой,
всегда сначала сверяйся с документацией Allpay.
Если мои инструкции или предыдущие ответы противоречат документации — следуй документации.
Данные для интеграции
API login: [вставьте ваш API login]
API key хранится в переменной окружения: [вставьте название переменной]
<span class="u-richtext-counter">4</span> В Allpay включите тестовый режим и используйте тестовые карты для проверки платежей. Не забудьте отключить тестовый режим перед запуском реальных продаж.
Видеообзор интеграции платежей на примере Lovable
Советы на случай трудностей Если вы столкнулись с проблемами:
настаивайте на строгом применении документации API, снова передавая ссылку на неё; публикуйте проект после выполнения каждого промпта; просите вывести ошибки в консоль браузера (клавиша F12) и передавайте в чат скриншоты ошибок; убедитесь, что API login и API key скопированы корректно. Вспомогательные промпты Сокрытие поля теудат зеута Поле ввода номера теудат зеута можно скрыть на странице оплаты, если ваши плательщики находятся за пределами Израиля.
На основе документации API Allpay сделай так, чтобы Allpay при оплате не запрашивал у клиента номер теудат зеута.
Документация: https: //www.allpay.co.il/api-reference
Внедрение Hosted Fields Hosted Fields используются для приёма оплаты на сайте без редиректа. Их следует внедрять только после успешной настройки оплаты через редирект, убедиться, что все работает корректно и затем попросить заменить редирект на Hosted Fields.
Через Hosted Fields могут быть доступны не все методы быстрой оплаты. Внедри Hosted Fields от Allpay согласно документации:
https: //www.allpay.co.il/en/help/hosted-fields
Необходимо изменить логику оформления заказа так, чтобы после ввода имени и e-mail клиента iframe с полями ввода карты отображался на той же странице, а оплата проходила без переадресации.
На сторонее Allpay нужно сделать 2 вещи:
<span class="u-richtext-counter">1</span> Сменить переключатель с редиректа на Hosted Fields в настройках интеграции:
<span class="u-richtext-counter">2</span> Зайти в настройки Hosted Fields и прописать там домен вашего сайта:
Рекуррентные списания по токенам Сначала внедрите обычные платежи и убедитесь, что они работают корректно. Затем используйте промпт ниже, чтобы реализовать следующую логику:
<span class="u-richtext-counter">1</span> По каждому успешному платежу можно запросить токен — это зашифрованный слепок карты, с которой был выполнен платеж.
<span class="u-richtext-counter">2</span> Сохраните полученный токен.
<span class="u-richtext-counter">3</span> При наступлении времени очередного списания инициируйте платеж, передав в Allpay сохраненный токен карты.
Используйте рекомендации по построению интерфейса для работы с рекуррентными платежами.
Вы несете ответственность за то, чтобы клиент дал вам четко выраженное согласие на совершение рекуррентных платежей. Обнови существующую логику: добавь рекуррентные платежи к обычным платежам с использованием токенов Allpay, строго следуя официальной документации Allpay.
Ключевое изменение: вместо повторного ввода карты используй token-based списания через параметр allpay_token.
Логика работы
1 ) Первый платеж (инициальное списание)
Первый платеж клиента выполняется как обычный Payment request в Allpay согласно документации.
2 ) Запрос и хранение токена
После успешного платежа запроси токен карты согласно документации: https: //www.allpay.co.il/api-reference#tokens
Параметр: allpay_token.
Сохрани полученный allpay_token и привяжи его к:
пользователю,
подписке,
платежному методу.
allpay_token хранится как основной платежный идентификатор карты и полностью заменяет карту для всех будущих списаний.
3 ) Повторные (рекуррентные) списания
При наступлении времени очередного списания сформируй новый Payment request в Allpay согласно документации:
https: //www.allpay.co.il/api-reference#payment-protocol
В запросе:
передай сохраненный токен в параметре allpay_token,
передай все остальные обязательные параметры, описанные в разделе Payment request.
Если параметр allpay_token передан:
Allpay выполнит списание автоматически,
в ответ вернет результат — успешное или неуспешное списание.
4 ) Обработка ответа Allpay
При успешном списании:
пометь платеж как succeeded,
обнови общую сумму списаний по подписке,
рассчитай и сохрани дату следующего списания.
При неуспешном списании:
пометь платеж как failed,
сохрани причину ошибки из ответа Allpay,
статус подписки автоматически не меняй (если иное не предусмотрено логикой сайта).
5 ) Логика подписки
Каждая подписка должна иметь один валидный allpay_token.
Все последующие списания по подписке выполняются только по этому токену.
Создание подписки невозможно, если первый платеж не был успешно выполнен и токен не получен.
Если клиент повторно оформляет подписку и выполняет платеж новой картой, необходимо запросить и сохранить новый allpay_token. В этом случае у клиента в базе может храниться несколько карт — по одному токену на каждую.
Для дебага и реализации строго следуй документации Allpay:
https: //www.allpay.co.il/api-reference
Итог
- Клиент выполняет первый платеж вручную.
- По успешному платежу запрашивается и сохраняется allpay_token.
- Все последующие автоматические списания выполняются только по токену.
- При оплате новой картой запрашивается и сохраняется отдельный токен для этой карты.
Пример внедрения рекуррентных платежей на Lovable
