Справочник API и OpenAPI

Публичный Merchant API версии v1. Базовый адрес не зашит: вам выдают его при подключении (ELEVENPAY_BASE_URL, см. Окружения).

Схема OpenAPI (машиночитаемая)

• /openapi.json — точка входа для инструментов и ИИ-агентов.
• /openapi/eleven-pay-public.json — тот же документ (прежний путь).

Схема формируется из исходного контракта Eleven Pay по явному allowlist и содержит только публичные пути и модели интеграции. Внутренние маршруты кабинета, оператора и провайдера в неё не входят. Адрес сервера в ней — переменная {api_base_url} без значения по умолчанию.

Endpoints

Метод и путь	Возможность ключа	Что делает
POST /v1/cashier/invoices	cashier.invoice.create	поставить в очередь счёт плательщику; идемпотентно — Счета Cashier
GET /v1/cashier/invoices/{reference}	payment.read	прочитать счёт и его платёж — Статусы
POST /v1/payments	payment.create	создать платёж с действием оплаты; идемпотентно — Создание платежа
GET /v1/payments/{public_reference}	payment.read	прочитать платёж — Сверка

Все четыре: Authorization: Bearer <ключ>, ответы JSON, серверное использование ключа. POST требует Idempotency-Key. Лишние поля в теле запрещены.

Общие заголовки ответа

• Idempotency-Replayed: true|false — на успешных ответах POST: был ли это безопасный повтор.
• Retry-After — на 429.
• WWW-Authenticate: Bearer — на 401.

Вебхуки — входящий контракт

Проверка подписи относится к входящим запросам на ваш сервер и не является HTTP-endpoint Eleven Pay: Проверка подписи, События, Доставка и повторы.

Не входит в эту редакцию

Другие возможности (возвраты, песочница сценариев, клиенты и т. п.) в коде существуют, но здесь не описаны и не включены в OpenAPI: не опирайтесь на них без отдельной договорённости.

Ошибки

Единый формат и таблица кодов — Ошибки.