Переход с Crypto Pay

Интеграция под Crypto Pay (CryptoBot) работает в Kivix Pay почти без изменений, а перейти на v1 можно постепенно.

Старые методы продолжают работать

Методы в стиле Crypto Pay доступны по адресу https://kivix.cc/api/… с заголовком Crypto-Pay-API-Token и ответом {"ok": true, "result": …}. Достаточно поменять адрес и токен.

Соответствие методов

Crypto Pay	Kivix Pay v1
`getMe`	`GET /v1/me`
`createInvoice`	`POST /v1/invoices`
`getInvoices`	`GET /v1/invoices`
`deleteInvoice`	`POST /v1/invoices/{id}/cancel`
`getBalance`	`GET /v1/balance`
`getCurrencies`	`GET /v1/currencies`
вебхук `invoice_paid`	событие `invoice.paid` + подпись `Kivix-Signature`

Что даёт v1

🔁 order_id

Свой номер заказа — повтор не создаст второй счёт, искать счёт можно по нему.

↩️ success_url

После оплаты покупатель возвращается к вам кнопкой в боте.

🧯 Понятные ошибки

Честные HTTP-коды и поле, которое не понравилось.

📦 SDK

Python, Node.js и PHP с проверкой вебхука одной строкой.

Вебхуки при переходе

Каждое событие содержит и новые поля (type, data.invoice), и прежние (update_type, invoice_id, …), а также оба набора заголовков (Kivix-Signature и X-Pay-Signature). Старый обработчик продолжит работать, пока вы переписываете его на v1.