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

Kivix Pay принимает криптоплатежи через Telegram. Вы создаёте счёт через API, покупатель платит из своего кошелька Kivix в один тап, вы получаете подписанный вебхук и выдаёте товар.

🚀Быстрый стартПервый счёт за 5 минут 📦БиблиотекиPython · Node.js · PHP 🧾СчетаСоздание, статусы, поиск 🔔ВебхукиСобытия и проверка подписи 🧯Ошибки и лимитыКоды и что с ними делать 📖Справочник APIВсе эндпоинты и поля

Как это работает

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

Создаёте счёт

POST /v1/invoices с суммой и номером заказа.

Даёте ссылку

Отправляете покупателю pay_url — это ссылка на бота.

Он платит

Видит сумму, жмёт «Оплатить». После оплаты может вернуться в магазин.

Вы получаете вебхук

invoice.paid с подписью — выдаёте товар.

Основные понятия

Приложение

Ваш магазин или сервис в Kivix Pay. У него свой API-ключ, секрет вебхуков и баланс. Создаётся в боте.

Счёт (invoice)

Запрос на оплату: сумма, монета, описание, номер заказа. Статусы: active → paid, expired или cancelled.

Событие (event)

Что-то произошло — например, счёт оплачен. Приходит вебхуком на ваш сервер и видно в GET /v1/events.

Баланс приложения

Сюда падают оплаты. Вывод — в боте: «Kivix Pay → приложение → Вывести на кошелёк».

Адрес API

https://kivix.cc/v1

Только HTTPS. Ответы — JSON. Нужен API-ключ: как его получить и передать.