Промпты для ИИ-ассистентов
Скопируйте нужный промпт и отправьте своему ассистенту — ChatGPT, Claude, Cursor или no-code инструменту. Каждый промпт ссылается на машиночитаемую документацию /docs/api.md, поэтому ассистент работает по действующей редакции контракта, а не по пересказу.
Ключ интеграции выдаём по запросу — напишите на support@kazpayment.kz.
Подключить оплату к сайту или боту
Основной промпт: ассистент прочитает контракт и напишет код создания заказа и приёма вебхука.
Прочитай документацию https://kazpayment.kz/docs/api.md и подключи приём оплаты KazPayment в мой проект: создание заказа (POST /api/v1/orders с идемпотентным external_ref), переход покупателя по pay_url, обработчик вебхука об оплате с проверкой подписи X-Kazpayment-Signature ДО разбора JSON. Ключ интеграции и секрет вебхука вынеси в переменные окружения — значения я подставлю сам.
Только приёмник вебхука
Если заказы вы уже создаёте, а обработчика оплаты ещё нет.
По документации https://kazpayment.kz/docs/api.md напиши обработчик вебхука KazPayment для моего стека: проверка HMAC-подписи заголовка X-Kazpayment-Signature по сырому телу запроса до его разбора, дедупликация по event_id, быстрый ответ 200 и обработка события в фоне, отдельный лог для запросов с неверной подписью.
Проверить готовую интеграцию
Ассистент сверит ваш код с контрактом и найдёт пропущенные места.
Сверь мою интеграцию с KazPayment с документацией https://kazpayment.kz/docs/api.md и перечисли расхождения: идемпотентность заказа по external_ref, обработка кодов ошибок (в том числе order_amount_differs и 429), проверка подписи вебхука, поведение при повторной доставке события, что происходит при таймауте сети между созданием заказа и получением ответа.
Для no-code (Lovable, Bolt, n8n)
Инструментам, которые умеют читать документацию по ссылке.
Используй как документацию API этот адрес: https://kazpayment.kz/docs/api.md. Мне нужен приём оплаты KazPayment: создание заказа на сумму из моей формы, редирект покупателя на pay_url и обработка вебхука об оплате с проверкой подписи.