Документация Eleven Pay

Eleven Pay — платёжный коннектор для Казахстана с единым, провайдер-нейтральным API. Ваш сервер создаёт платёж или счёт, Eleven Pay сообщает о результате подписанным вебхуком, а вы выдаёте товар или услугу ровно один раз. Внутренние особенности платёжных провайдеров скрыты за границей коннектора — вы интегрируетесь с Eleven Pay, а не с провайдером.

Пилотный режим

Eleven Pay сейчас доступен в режиме пилота/разработки. API-контракты, действия оплаты и вебхуки реализованы, но фактическая доступность приёма платежей зависит от подключения и онбординга вашей организации. Не считайте сервис общедоступным в продакшене. Публичный адрес Merchant API ещё не определён: базовый адрес вам выдают при подключении (см. Окружения).

Eleven Pay — независимый сервис. Он не принадлежит, не одобрен и не связан официально ни с одним банком или платёжным провайдером; их названия встречаются в документации только для описания того, что делает API. Этот сайт — статическая документация: он не является API и не принимает запросов.

Выберите путь интеграции

Путь	Когда	Начать
Счёт плательщику (Cashier)	вы знаете телефон плательщика; запрос на оплату приходит ему в приложение банка; подтверждение — вебхуком	Счета Cashier
Платёж с действием оплаты	вы показываете плательщику QR или перенаправляете его (action)	Создание платежа

Оба пути используют один и тот же Bearer-ключ, одну и ту же идемпотентность и одни и те же подписанные вебхуки.

Что вы можете интегрировать

• Создание счёта — POST /v1/cashier/invoices; создание платежа — POST /v1/payments (оба идемпотентны).
• Чтение статуса — GET /v1/cashier/invoices/{reference}, GET /v1/payments/{reference}.
• Вебхуки — подписанное событие payment.succeeded на ваш сервер.

С чего начать

• Быстрый старт — кратчайшая корректная интеграция.
• Аутентификация — Bearer-ключи, окружения, возможности.
• Идемпотентность — как не создать дубль.
• Проверка подписи вебхука — обязательно перед обработкой.
• Чек-лист перед запуском и Безопасность.
• Для ИИ-агентов — пошаговое руководство для автоматической интеграции, машиночитаемый контракт: /openapi.json.
• На казахском: Бастау.

Базовый адрес и версия

Текущая версия — v1 (все пути начинаются с /v1). Базовый адрес не зашит в документацию: задавайте его переменной ELEVENPAY_BASE_URL. Ключ создаётся в кабинете мерчанта app.eleven.kz.

Термины

Термин	Значение
reference	Публичный идентификатор платежа/счёта Eleven Pay (ep1_…); используйте его в GET.
merchant_order_id	Ваш бизнес-идентификатор заказа (задаёте вы, 1–100 символов A-Za-z0-9_.:-).
Idempotency-Key	Ключ одной логической команды создания (для безопасных повторов).
Действие оплаты	Провайдер-нейтральный объект qr / redirect / null (путь «платёж»).
Расчёт подтверждён	Платёж status = succeeded (и для счёта settled = true) — из вебхука или GET.