Промпты и руководства для интеграции

Подключи в мой проект приём онлайн-платежей через ApiPay.kz (apipay.kz) — это сервис приёма платежей Kaspi Pay.

Пошаговая инструкция для тебя: https://apipay.kz/for-ai

Открой её и действуй строго по шагам. Когда понадобятся мои данные (API-ключ, секрет вебхука) или ручные действия в личном кабинете — остановись и попроси меня.

Используй ApiPay.kz для приёма платежей через Kaspi Pay. Аутентификация — заголовок X-API-Key. Создание счёта — POST /invoices с phone_number и amount. Полная инструкция: https://apipay.kz/for-ai

Ты — тест-агент интеграции с ApiPay.kz (приём платежей Kaspi Pay). У тебя есть sandbox-ключ X-API-Key (тестовая организация, is_sandbox: true). База: https://api.apipay.kz/api/v1. Заголовок: X-API-Key. Пройди полный цикл сам, без человека, и по каждому шагу проверяй доставку вебхука через GET /webhook-logs.

Важно: POST /invoices/{id}/simulate-status работает ТОЛЬКО в песочнице; на боевом счёте он всегда вернёт 403 not_sandbox. Симулировать можно только счёт в статусе pending (иначе 400 invalid_status_transition).

Шаги:
1. Создай счёт: POST /invoices { "phone_number": "87770000001", "amount": 5000, "description": "Autotest", "external_order_id_idempotency": "autotest-001" }. Запомни id.
2. Дождись статуса pending: счёт создаётся в processing, переход асинхронный — поллинг GET /invoices/{id} раз в 1-2 секунды (обычно 1-3 секунды). simulate-status требует pending.
3. Оплата: POST /invoices/{id}/simulate-status { "status": "paid" }.
4. Проверь вебхук: GET /webhook-logs?invoice_id={id}&event=invoice.status_changed — должна быть запись со status: success (приёмник ответил 2xx). Если ответ пуст — проверь по ?invoice_id={id} без event: тип события есть в request_body записи.
5. Частичный возврат: POST /invoices/{id}/refund { "amount": 2000 } (в песочнице проходит без Kaspi; статус paid → partially_refunded).
6. Проверь вебхуки: GET /webhook-logs?invoice_id={id} — должны быть invoice.refunded и invoice.status_changed (partially_refunded).
7. Отдельными новыми sandbox-счетами (каждый — дождаться pending, как в шаге 2) проверь ветки:
   - simulate-status { "status": "cancelled" } → invoice.status_changed (cancelled)
   - simulate-status { "status": "expired" }   → invoice.status_changed (expired)
   - simulate-status { "status": "error", "error_message": "Тест" } → error_code: sandbox_simulated_error
8. QR: создай POST /invoices/qr с телом { "amount": 5000, "description": "QR autotest" } — phone_number не нужен, счёт сразу pending. Затем simulate-status { "status": "qr_scanned" } → вебхук invoice.qr_scanned (qr_substate: scanned, статус остаётся pending). Повторный qr_scanned → 400 already_scanned.

Учти: sandbox-вебхуки идут с 3 попытками (backoff 5с/15с), успех — любой HTTP 2xx. Если по шагу вебхука ещё нет — подожди и перечитай /webhook-logs.

Критерий успеха: по каждому шагу в /webhook-logs есть ожидаемое событие со status: success. В конце дай отчёт: какие события пришли, какие http_status у доставок, где были ошибки.