Для ИИ-агентов

Документация EGN Pay доступна в машиночитаемом виде. Если вы ИИ-агент и интегрируете сервис с EGN Pay, начните отсюда.

Ресурс	URL
Индекс для LLM	https://pay.egnetwork.ru/llms.txt
Вся документация одним файлом	https://pay.egnetwork.ru/llms-full.txt
OpenAPI 3.1	https://pay.egnetwork.ru/openapi.json
TypeScript SDK (один файл)	https://pay.egnetwork.ru/sdk/egn-pay.ts
Любая страница в Markdown	добавьте `.md`, например https://pay.egnetwork.ru/docs/webhooks.md

Промпт для агента

Скопируйте в задачу агенту, который подключает сервис:

Подключи оплату через EGN Pay. Документация: https://pay.egnetwork.ru/llms-full.txt, спецификация: https://pay.egnetwork.ru/openapi.json.

Требования:
0. Для TypeScript-проектов скачай SDK: curl -o src/lib/egn-pay.ts https://pay.egnetwork.ru/sdk/egn-pay.ts
1. Ключ EGN_PAY_KEY и секрет EGN_PAY_WEBHOOK_SECRET бери из переменных окружения, только на бэкенде.
2. При оформлении заказа вызывай POST /api/v1/payments: amount в копейках, order_id = стабильный ID заказа,
   description, return_url, customer.email или customer.phone (обязательно — для чека), metadata с нашим user_id. Редиректни пользователя на payment_url.
3. Сделай эндпоинт вебхука: проверь подпись X-EGN-Signature по сырому телу (HMAC-SHA256, "t.body", допуск 5 минут),
   на payment.succeeded идемпотентно выдай заказ по data.payment.order_id, на failed/expired/canceled закрой заказ, ответь 200.
4. На странице return_url не доверяй параметру status — запроси GET /api/v1/payments/{payment_id}.
5. Покрой тестом на egn_test_ ключе через POST /api/public/payments/{id}/simulate.

Ключевые факты

Базовый URL API: https://pay.egnetwork.ru/api/v1
Аутентификация: Authorization: Bearer egn_live_… / egn_test_…
Суммы — целые числа в копейках, валюта RUB
Идемпотентность — по order_id в пределах сервиса и режима
Вебхуки: X-EGN-Signature: t=…,v1=hex(HMAC_SHA256(secret, t + "." + body))
Статусы: pending, succeeded, failed, expired, canceled, partially_refunded, refunded

Markdown-версия этой страницы: /docs/agents.md