Быстрый старт

От нуля до первого оплаченного счёта — четыре шага и пять минут.

1. Получите API-ключ

Откройте бота → ➕ Ещё → 💼 Kivix Pay → ➕ Создать приложение. Бот один раз покажет API-ключ (kp_…) и секрет вебхуков (whsec_…) — сохраните оба.

Ключ даёт доступ к счетам вашего приложения. Храните его на сервере, не вставляйте во фронтенд и не коммитьте в git. Если ключ утёк — перевыпустите его в боте: старый сразу перестанет работать.

2. Поставьте библиотеку

Можно и без неё — это обычный HTTP, — но с SDK короче и надёжнее.

pip install kivix-pay

npm install kivix-pay

composer require kivix/pay

# ничего ставить не нужно

3. Создайте счёт

from kivix_pay import KivixPay

pay = KivixPay("kp_...", base_url="https://kivix.cc")
invoice = pay.invoices.create(
    amount="12.50", asset="USDT", order_id="1001",
    description="Заказ #1001", success_url="https://shop.example/thanks",
)
print(invoice.pay_url)

import { KivixPay } from "kivix-pay";

const pay = new KivixPay("kp_...", { baseUrl: "https://kivix.cc" });
const invoice = await pay.invoices.create({
  amount: "12.50", asset: "USDT", orderId: "1001",
  description: "Заказ #1001", successUrl: "https://shop.example/thanks",
});
console.log(invoice.pay_url);

use Kivix\Pay\KivixPay;

$pay = new KivixPay('kp_...', 'https://kivix.cc');
$invoice = $pay->invoices->create([
    'amount' => '12.50', 'asset' => 'USDT', 'order_id' => '1001',
    'description' => 'Заказ #1001', 'success_url' => 'https://shop.example/thanks',
]);
echo $invoice['pay_url'];

curl https://kivix.cc/v1/invoices \
  -H "Authorization: Bearer $KIVIX_PAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": "12.50", "asset": "USDT", "order_id": "1001",
       "description": "Заказ #1001", "success_url": "https://shop.example/thanks"}'

В ответе — объект счёта. Главное поле — pay_url.

4. Отправьте ссылку и дождитесь оплаты

Отправьте покупателю pay_url — кнопкой в вашем боте, ссылкой на сайте или в сообщении. Ссылка открывает бота с карточкой счёта: сумма, описание, кнопка «Оплатить».

Узнать об оплате можно двумя способами:

🔔 Вебхук (рекомендуем)

Задайте адрес — после оплаты придёт invoice.paid. Как настроить и проверить подпись.

🔄 Опрос

Нет своего сервера? Раз в несколько секунд проверяйте GET /v1/invoices/{id}, пока статус active.

Готово! Дальше: всё о счетах, вебхуки, ошибки.