Справочник API

Фактическая готовность интеграций

Ответы

Состояние API и таблиц D1

not_configured допускает status=ok: публичные страницы и поиск могут работать без DB. Наличие DB с недоступными таблицами даёт 503/degraded. Ответ не проверяет работоспособность Telegram или модели по сети.

Ответы

Публичный машиночитаемый контракт

Только чтение. Не содержит секретов, сессий, данных пользователей или рабочего контракта платёжного провайдера.

Ответы

Run due delivery and application jobs

Server scheduler entrypoint. Requires JOBS_SECRET, not a browser session or merchant key. Does not accept job IDs or arbitrary outbound URLs.

Ответы

Текущая сессия и CSRF

Ответы

Начать вход или регистрацию

Создаёт challenge на 300 секунд и HttpOnly cookie browser proof; максимум 6 запусков в минуту по хешу адреса. Сравните шестизначный код на сайте и в личном чате бота.

Заголовки и параметры

Тело JSON

Ответы

Завершить подтверждённый вход

Требует proof cookie из start и того же браузера. Pending возвращает 202. После подтверждения ботом запрос выдаёт одну сессию на 24 часа. Максимум 90 проверок в минуту на challenge. Значение Telegram ID из браузера не принимается.

Заголовки и параметры

Тело JSON

Ответы

Завершить текущую сессию

Тело не требуется и не читается. /logout в боте отдельно завершает все сессии аккаунта.

Заголовки и параметры

Ответы

Настройки текущего пользователя

Ответы

Изменить название, плательщика НДС или уведомления

Все поля необязательны; частичный patch. Сервер сохраняет настройку vatPayer, но не создаёт денежную операцию. Переключатели payments/payouts не подключают платёжный шлюз.

Заголовки и параметры

Тело JSON

Ответы

Список собственных ссылок

Сортировка createdAt DESC, id DESC. Публичные ссылки читаются между устройствами; доступ к списку требует аккаунт.

Заголовки и параметры

Ответы

Создать счёт с неизменными условиями

Create an immutable invoice and immediately receive checkoutUrl; this does not charge the buyer. USD: card/Alipay; RUB: SBP; USDT: crypto. USD crypto remains accepted for compatibility but cannot be paid without a USDT invoice. Fee and VAT customer shares are independent integers from 0 to 100; current live card/Alipay supports VAT customer=100 and fee customer=0. The customer total is never silently changed. Latest website application must be approved before a new live charge. Invoice creation and its merchant event commit atomically.

Заголовки и параметры

Тело JSON

Ответы

Собственная ссылка и сохранённый расчёт

Заголовки и параметры

Ответы

Приостановить, возобновить или отменить ссылку

Changes only status. The update and immutable invoice.updated event commit atomically. Concurrent changes use a version check; refresh and retry on LINK_CHANGED. cancelled is terminal, expiration is never extended, and price, methods, cost shares and description stay frozen. Repeating the saved status returns the current invoice.

Заголовки и параметры

Тело JSON

Ответы

Публичные детали счёта для покупателя

Read the immutable public invoice quote and its persisted payment snapshot. method must belong to the invoice. No account is required. Does not expose owner identity, private metadata or merchant proceeds. The token grants access only to this checkout. availability reflects configuration, allocation, technical limits and merchant approval; payment confirmation is separate.

Заголовки и параметры

Ответы

Start or recover the invoice payment

Same-origin buyer operation; no account or CSRF token required. The server reserves one operation and a stable idempotency key before gateway dispatch. A repeat recovers the same operation; a lost response must be resolved through status. The payment method locks after dispatch. Card data must be browser-encrypted with a fresh payment intent. SBP/crypto send the saved customer total; card/Alipay use the supported immutable tax configuration. New charges require an approved merchant application. Existing dispatched payments can be recovered after invoice expiration, pause or approval changes. No /v2 or hosted-card route is used.

Заголовки и параметры

Тело JSON

Ответы

Read and refresh the same payment

No account is required. Refreshes an existing operation over authenticated gateway transport, with server-side throttling. No new payment is created. Returns null if nothing was dispatched. Confirm an order only when fulfillmentReady is true.

Заголовки и параметры

Ответы

Request an authoritative status reconciliation

Reads the existing operation and asks the gateway to reconcile its provider status. Does not create a payment. At most 3 requests per invoice per minute. Available for already-dispatched payments even if the invoice is no longer active.

Заголовки и параметры

Тело JSON

Ответы

Obtain a gateway public key and a bound encryption intent

The gateway alone owns the private key. An intent expires within five minutes and binds the merchant order, currency, base/total amounts, operation idempotency key and purpose. payment intents require an active invoice and approved merchant; code intents require an existing, current bank challenge. No PAN, CVV, bank code, or private JWK fields are accepted by this endpoint. At most 8 intents per invoice and 12 per client per minute. The encrypted plaintext is {intent,name,country,email?,card:{number,expiration,cvv,holder}} for payment or {intent,code} for code. Plaintext is assembled only inside the browser before JWE encryption.

Заголовки и параметры

Тело JSON

Ответы

Relay an encrypted code for the current bank challenge

Obtain a purpose=code intent and encrypt {intent,code} in the browser. The gateway validates the current challenge and consumes the sealed intent once. Kevmi never receives plaintext code. At most 5 submissions per invoice per minute; refresh status after an uncertain response.

Заголовки и параметры

Тело JSON

Ответы

Read the current coin and network catalog

Only for a USDT invoice that allows crypto. The invoice remains denominated in USDT; the gateway quotes the chosen payer coin. Never assume USD equals USDT or convert the transfer amount to a floating-point number. At most 10 catalog reads per invoice per minute.

Заголовки и параметры

Ответы

Ответ по всей публичной базе знаний

Публичный вопрос без сессии и CSRF. Переданный Origin должен совпасть с APP_ORIGIN; агенты могут не отправлять Origin. В AI-режиме сервер передаёт все опубликованные статьи, факты, каталог страниц и готовность функций. Необязательные history и pageContext используются только как недоверенный контекст вопроса. Доступа к аккаунтам, деньгам, приватным обращениям и инструментам у модели нет. При D1 действует лимит 12 вопросов/минуту по хешу адреса. Режим ai требует D1, корректной конфигурации провайдера и квоты: по умолчанию 60 генераций/час на весь сервис. Готовность конфигурации не подтверждает доступность внешнего API. Ошибка провайдера, превышение квоты или некорректный ответ возвращают search с aiUnavailable=true и HTTP 200. Без генеративной конфигурации возвращается обычный search.

Заголовки и параметры

Тело JSON

Ответы

Последние 30 собственных обращений

Ответы

Сохранить обращение

До 6 обращений в час на пользователя, общая квота сайта и бота. Сохранение создаёт обращение в аккаунте. Используйте его номер для уточнения статуса.

Заголовки и параметры

Тело JSON

Ответы

Прочитать своё обращение

Заголовки и параметры

Ответы

Закрыть своё обращение

Метод принимает только status=closed. Он не поддерживает повторное открытие, редактирование сообщений или отправку ответов.

Заголовки и параметры

Тело JSON

Ответы

Страница собственных уведомлений

До 30 записей: createdAt DESC, затем id DESC. Чтение списка не меняет readAt и не запускает доставку. unreadCount — общее число непрочитанных событий текущего пользователя, независимо от страницы. Поля владельца, Telegram ID и секреты не возвращаются.

Заголовки и параметры

Ответы

Отметить собственные уведомления прочитанными

Принимается одна из двух форм: ids либо all:true вместе с before. before — дата последнего уже наблюдавшегося события; значение не должно быть позже текущего времени сервера. Более новые события сохраняются непрочитанными. Повторный запрос идемпотентен: readAt уже прочитанных записей не меняется. Чужие и отсутствующие ids не изменяются и не раскрываются. status и sentAt доставки Telegram остаются прежними.

Заголовки и параметры

Тело JSON

Ответы

Отправить тестовое уведомление в свой Telegram

Это действие ставит сообщение в очередь и пытается отправить его. Максимум 3/час на пользователя. Тест не является уведомлением об оплате и не меняет баланс. HTTP 202 не подтверждает доставку; проверяйте список уведомлений.

Заголовки и параметры

Тело JSON

Ответы

Принять событие Telegram Bot API

Только секретный заголовок Telegram, без session/CSRF/Origin. Дополнительные поля Update разрешены. Обрабатываются message и callback_query, персональные действия только в private-чате подтверждённого отправителя. Прочие события пропускаются. update_id дедуплицируется; выполняющийся update даёт 503 для повтора. Это не webhook платёжного провайдера.

Тело JSON

Ответы

Денежная операция отключена

Возвращает 503 GATEWAY_NOT_CONNECTED. Денежные операции недоступны. Тело не обрабатывается, запрос к шлюзу не выполняется.

Ответы

Денежная операция отключена

Возвращает 503 GATEWAY_NOT_CONNECTED. Денежные операции недоступны. Тело не обрабатывается, запрос к шлюзу не выполняется.

Ответы

Список собственных ссылок

Сортировка createdAt DESC, id DESC. Публичные ссылки читаются между устройствами; доступ к списку требует аккаунт.

Заголовки и параметры

Ответы

Создать счёт с неизменными условиями

Create an immutable invoice and immediately receive checkoutUrl; this does not charge the buyer. USD: card/Alipay; RUB: SBP; USDT: crypto. USD crypto remains accepted for compatibility but cannot be paid without a USDT invoice. Fee and VAT customer shares are independent integers from 0 to 100; current live card/Alipay supports VAT customer=100 and fee customer=0. The customer total is never silently changed. Latest website application must be approved before a new live charge. Invoice creation and its merchant event commit atomically.

Заголовки и параметры

Тело JSON

Ответы

Собственная ссылка и сохранённый расчёт

Заголовки и параметры

Ответы

Приостановить, возобновить или отменить ссылку

Changes only status. The update and immutable invoice.updated event commit atomically. Concurrent changes use a version check; refresh and retry on LINK_CHANGED. cancelled is terminal, expiration is never extended, and price, methods, cost shares and description stay frozen. Repeating the saved status returns the current invoice.

Заголовки и параметры

Тело JSON

Ответы

Список собственных ссылок

Сортировка createdAt DESC, id DESC. Публичные ссылки читаются между устройствами; доступ к списку требует аккаунт.

Заголовки и параметры

Ответы

Создать счёт с неизменными условиями

Create an immutable invoice and immediately receive checkoutUrl; this does not charge the buyer. USD: card/Alipay; RUB: SBP; USDT: crypto. USD crypto remains accepted for compatibility but cannot be paid without a USDT invoice. Fee and VAT customer shares are independent integers from 0 to 100; current live card/Alipay supports VAT customer=100 and fee customer=0. The customer total is never silently changed. Latest website application must be approved before a new live charge. Invoice creation and its merchant event commit atomically.

Заголовки и параметры

Тело JSON

Ответы

Собственная ссылка и сохранённый расчёт

Заголовки и параметры

Ответы

Приостановить, возобновить или отменить ссылку

Changes only status. The update and immutable invoice.updated event commit atomically. Concurrent changes use a version check; refresh and retry on LINK_CHANGED. cancelled is terminal, expiration is never extended, and price, methods, cost shares and description stay frozen. Repeating the saved status returns the current invoice.

Заголовки и параметры

Тело JSON

Ответы

List own key metadata

Ответы

Create a scoped key; reveal its secret once

Maximum 10 active keys. At most 5 creations/hour/user. Keys expire, can be revoked and are rate-limited to 90 API requests/minute/key.

Заголовки и параметры

Тело JSON

Ответы

Revoke own key

Заголовки и параметры

Ответы

Read own immutable event history

Заголовки и параметры

Ответы

Read own immutable event history

Заголовки и параметры

Ответы

List endpoints and last 30 deliveries

Ответы

Register a public HTTPS destination

Up to 5 endpoints and 6 creations/hour/user. Public HTTPS domains only; no credentials, IP literals or custom ports. A newly created endpoint receives no live deliveries until its challenge succeeds.

Заголовки и параметры

Тело JSON

Ответы

List endpoints and last 30 deliveries

Заголовки и параметры

Ответы

Pause or resume a verified endpoint

Paused verified endpoints keep eligible events in the queue; resuming processes due deliveries.

Заголовки и параметры

Тело JSON

Ответы

Remove endpoint and cancel undelivered jobs

Cancels pending, failed and leased jobs. A request already sent across the network cannot be recalled.

Заголовки и параметры

Ответы

Send a signed endpoint.verification challenge

Maximum 5 verification attempts/hour/user. Your server must validate Kevmi-Signature and return 2xx JSON {"challenge":"<data.challenge>"}. Request timeout: 8 seconds; response cap: 8192 bytes. Redirects are not followed. Verification activates the endpoint.

Заголовки и параметры

Тело JSON

Ответы

Replace signing secret and require verification again

Maximum 3 rotations/hour/user. Update your server and verify the endpoint again. An already in-flight request may still carry the previous signature.

Заголовки и параметры

Тело JSON

Ответы

Retry a failed delivery to an active endpoint

Retains event ID and payload; generates a fresh timestamp and signature. Each automatic delivery cycle makes at most 6 attempts, including expired leases, with delays of 1m, 5m, 30m, 2h and 12h. Delivery is at least once; deduplicate event IDs on your server.

Заголовки и параметры

Тело JSON

Ответы

List up to 30 own applications

Заголовки и параметры

Ответы

Submit website information and receive a tracking URL

Requires confirmed Telegram sign-in. Up to 5 new submissions/day/user. Idempotent replay returns 200. The server advances real persisted stages; unavailable or risky automatic results require human review. Approval does not configure the payment gateway. Ownership and state cannot be supplied by the applicant.

Заголовки и параметры

Тело JSON

Ответы

Read own review stages and event history

Заголовки и параметры

Ответы

Resume an eligible background stage

Cannot skip review or approve a stage. A server lease prevents duplicate work. Needs-review and final applications remain unchanged. At most 30 processing-resume requests/minute/user.

Заголовки и параметры

Тело JSON

Ответы

List up to 100 applications for moderation

Requires the authenticated Telegram identity to be in MODERATOR_TELEGRAM_IDS. Includes all states, ordered needs_review first, processing second, then final states; newest updates first within a group.

Ответы

Read review evidence and stage history

Заголовки и параметры

Ответы

Approve the current review stage or decline with a public reason

Requires a configured moderator; at most 30 decisions/minute/user. expectedVersion is compared atomically. Only the current needs_review stage can be approved; final applications cannot be silently reopened. A rejection requires an editable public reason. The decision, stage history and enabled applicant notification are saved together.

Заголовки и параметры

Тело JSON

Ответы

Receive signed source-native gateway events

Native v3: supply X-Gateway-Timestamp (Unix seconds), X-Gateway-Signature and matching X-Gateway-Event-Id. Maximum timestamp skew is 300 seconds. After signature verification, Kevmi fetches the payment through the authenticated gateway API, checks saved order, exact currency/amount, method and provider-confirmed state, then atomically stores the receipt and merchant outbox event. Webhook text and browser observations alone never confirm a payment. Repeated IDs are deduplicated; a changed body for an existing ID is rejected. Delayed events use fresh authoritative state. Partial refunds, full refunds, disputes and review states are supported. Unbound orders are acknowledged and ignored. Legacy normalized events using Kevmi-Signature remain supported separately; only their succeeded/failed/full-refunded transitions apply.

Заголовки и параметры

Тело JSON

Ответы