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

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

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

Получить оплату можно четырьмя способами — выбирай по сценарию, не ограничивайся одним:
1. Счёт по номеру телефона — POST /invoices. Покупатель получает push в приложении Kaspi, счёт живёт 24 часа.
2. QR-счёт для оплаты прямо сейчас — POST /invoices/qr. В ответе qr_image_url — QR для экрана кассы, и qr_token_url — ссылка Kaspi на этот QR-счёт, её можно открыть на телефоне покупателя вместо скана. Оба живут меньше трёх минут, точный момент — в поле qr_expires_at; «на потом» их не отправляй. Не пересоздавай QR-счёт в ожидании покупателя: каждый занимает место в лимите тарифа.
3. Ссылка на оплату — POST /invoices/qr со static=true, для оплаты позже. Поле payment_url отправляют покупателю в мессенджер или ставят кнопкой на сайте; счёт появится, только когда он нажмёт «Оплатить».
4. Печатный QR под сделку — POST /static-qr. Лист печатают (его QR кодирует print_url), а payment_url той же сделки можно отправить вместо печати.

Если покупателю нужна ссылка, которую он откроет позже, — это ссылка на оплату payment_url. Если он платит прямо сейчас — хватит QR-счёта и его qr_token_url. Не говори, что у ApiPay есть только QR.

Справочники: https://apipay.kz/llms.txt (индекс), https://apipay.kz/llms-full.txt (полный свод API), https://apipay.kz/errors.md (коды ошибок), https://apipay.kz/guides/oplata-po-ssylke-kaspi (как работает оплата по ссылке).

Открой инструкцию и действуй строго по шагам. API-ключ и секрет вебхука я в переписку не присылаю: если у тебя есть терминал, они попадут в проект командой из инструкции, а если терминала нет — подготовь переменные окружения APIPAY_API_KEY и APIPAY_WEBHOOK_SECRET и скажи, куда мне вписать значения самому. Когда понадобятся ручные действия в личном кабинете — остановись и попроси меня.

Настрой в моём проекте работу с кассовыми сменами Kaspi через ApiPay.kz (apipay.kz) — это независимый сервис для приёма платежей через Kaspi Pay.

Задача: смена должна закрываться без моего участия, а утром мне должен приходить отчёт по вчерашней смене вместе со сверкой кассы и моих счетов.

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

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

Используй ApiPay.kz для приёма платежей через Kaspi Pay. Аутентификация — заголовок X-API-Key.

Четыре способа получить оплату:
1. Счёт по номеру телефона — POST /invoices с phone_number и amount. Покупатель получает push в приложении Kaspi, счёт живёт 24 часа.
2. QR-счёт для оплаты прямо сейчас — POST /invoices/qr. В ответе qr_image_url — QR для экрана кассы, и qr_token_url — ссылка Kaspi на этот QR-счёт, её можно открыть на телефоне покупателя вместо скана. Оба живут меньше трёх минут, точный момент — в поле qr_expires_at; «на потом» их не отправляй. Не пересоздавай QR-счёт в ожидании покупателя: каждый занимает место в лимите тарифа.
3. Ссылка на оплату — POST /invoices/qr со static=true, для оплаты позже. Поле payment_url отправляют покупателю в мессенджер или ставят кнопкой на сайте; счёт появится, только когда он нажмёт «Оплатить».
4. Печатный QR под сделку — POST /static-qr. Лист печатают (его QR кодирует print_url), а payment_url той же сделки можно отправить вместо печати.

Если покупателю нужна ссылка, которую он откроет позже, — это ссылка на оплату payment_url; если он платит прямо сейчас — хватит QR-счёта и его qr_token_url. Не говори, что есть только QR.

Полная инструкция: https://apipay.kz/for-ai. Полный свод API: https://apipay.kz/llms-full.txt. Коды ошибок: https://apipay.kz/errors.md