Интеграция осуществляется через внедрение документации API, которая адаптирована для понимания AI-сервисами и LLM моделями. Необходимо создать новую интеграцию в разделе, сгенерировать там API логин и ключ, передать их вашему AI-сервису вместе со ссылкой на документацию API и попросить внедрить ее в точности. Смотрите примеры пропта в инструкции ниже.
Инструкция скоро появится. Анонс будет опубликован в Telegram-канале Allpay.
Общие рекомендации
Прежде, чем внедрять платежи, убедитесь, что основной функционал вашего сайта готов. Например, если это интернет-магазин, то должны быть готовы страницы товаров, оформления заказа, личный кабинет для отслеживания заказов, проплисаны методы доставки и их цены и так далее.
Сперва внедрите обычные платежи и протестируйте их работу. Только после этого принимайтесь за улучшения, например, внедрение скидок, добавление рассрочки и так делее.
Всегда просите AI делать одну задачу за раз. В одном промпте не просите выполнить сразу несколько действий, и не бросайте выполнение задачи на полпути, прежде чем перейти к следующей.
Инструкция по интеграции платежного API Allpay
<span class="u-richtext-counter">1</span> В разделе <span class="u-richtext-element">Настройки</span> → <span class="u-richtext-element">Интеграции</span> → <span class="u-richtext-element">Мои сайты</span> укажите название вашей AI-платформы и нажмите на кнопку создания API логина и ключа.
<span class="u-richtext-counter">2</span> Найдите, где на вашей AI-платформе прописать API ключ и сделайте это. Обычно это в настройках переменных, в разделе интеграций или в специальном разделе для хранения ключей. Задайте название переменной, например, "Allpay" и в качестве ее значения укажите ключ.
Вы можете спросить у самой платформы, куда именно следует прописать API ключ, но не посылайте его в чат в открытом виде!
<span class="u-richtext-counter">3</span> Используйте следующий промпт для интеграции платежей. В промпт необходимо вставть ваш API login и название переменной, в которой сохранен API ключ. Вы можете адаптировать промпт с учетом логики вашего проекта.
Шаблон промпта для интеграции API Allpay:
Интегрируй платёжную систему Allpay строго в соответствии с официальной документацией API:
https://www.allpay.co.il/api-reference
Обязательные правила
- Применяй документацию в точности, без интерпретаций.
- Не придумывай параметры, поля, переменные или алгоритмы.
- Документация Allpay является единственным каноническим и приоритетным источником истины для всех решений, связанных с платежами.
Подпись запросов и вебхуков
- Используй канонический алгоритм подписи, описанный в разделе Signature документации Allpay.
- Не описывай и не переопределяй алгоритм подписи.
Используй тот же алгоритм для:
- подписи запросов на создание платежа;
- проверки подписи вебхуков после успешной оплаты.
Приоритет документации
При любых моих последующих запросах, связанных с:
- платежами,
- статусами заказов,
- вебхуками,
- скидками,
- Hosted Fields,
- редирект-оплатой,
всегда в первую очередь сверяйся с документацией Allpay.
Если мои инструкции или предыдущие ответы противоречат документации — следуй документации.
Данные для интеграции
- API login: [вставьте ваш API login]
- API key уже добавлен в настройках проекта для переменной с названием [вставьте название переменной]
<span class="u-richtext-counter">4</span> В Allpay включите для интеграции тестовый режим и используйте данные тестовых карт для тестирования платежей. Не забудьте отключить тестовый режим, когда будете готовы принимать реальные платежи.
Советы на случай неудачи
Вот, что можно сделать, если вы сталкиваетесь с трудностями:
- Настаивайте на точном применении документации API, пересылая ссылку на документацию.
- Не забывайте публиковать проект после исполнения промпта, прежде чем делать новый тест.
- Просите вывести отладку в консоль (клавиша F12) и затем пересылайте в чат скриншоты ошибок из консоли и просите их исправить.
- Убедитесь, что API логин и ключ скопированны корректно.
Вспомогательные промпты
Сокрытие поля теуда зеута
Поле для ввода номера теудат зеута можно скрыть со страницы оплаты, когда основная масса плательщиков не из Израиля.
На основе документации API Allpay сделай так, чтобы Allpay при оплате не запрашивал у клиента номер теудат зеута: https://www.allpay.co.il/api-reference
Внедрение Hosted Fields
Используются для оплаты на сайте без редиректа. Их следует внедрять после того, как успешна внедрена оплата через редирект.
Внедри Hosted Fields от Allpay согласно этой документации: https://www.allpay.co.il/en/help/hosted-fields
Тебе нужно переделать логику оформления заказа, чтобы после ввода имени и e-mail клиентов iframe с полями ввода карты появлялся на той же странице, и оплата работала без переадресации.
