Разработчикам

API для платёжных команд

Создавайте счета, перенаправляйте клиентов на checkout, получайте подписанные webhook-события и сверяйте статусы платежей в своей системе.

Получить API-ключ Связаться с поддержкой

Аутентификация

Передавайте ключ в заголовке. Все ответы — в формате JSON. Базовый URL: https://crynova.io/api/v1

Authorization: Bearer cryn_live_xxx
X-Api-Key: cryn_live_xxx

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

curl -X POST https://crynova.io/api/v1/invoices \
  -H "Authorization: Bearer cryn_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "149.00",
    "currency": "USDT_TRC20",
    "order_id": "ORD-1048",
    "description": "Order payment",
    "metadata": { "customer_id": "cus_9281" }
  }'

Возможности API

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

Генерируйте запросы на оплату с суммой, валютой, order ID и metadata.

Проверка статуса

Читайте состояние счёта для сверки и поддержки.

Webhook-события

Получайте invoice.paid, invoice.expired и обновления подтверждений.

Эндпоинты

Метод	Эндпоинт	Назначение
GET	/currencies	Список доступных валют и сетей.
GET	/invoices	Список счетов с фильтрами.
POST	/invoices	Создать счёт и получить адрес + checkout URL.
GET	/invoices/{uuid}	Полная информация о счёте.
GET	/invoices/{uuid}/status	Лёгкая проверка статуса и подтверждений.
POST	/invoices/{uuid}/cancel	Отменить неоплаченный счёт.

Ответ

{
  "invoice_id": "7a4f...",
  "status": "pending",
  "currency": "USDT_TRC20",
  "amount": "149.00",
  "pay_address": "TR7x...",
  "checkout_url": "https://crynova.io/pay/7a4f...",
  "expires_at": "2026-06-07T12:30:00+00:00"
}

Webhook — события и payload

X-Crynova-Event: invoice.paid
X-Crynova-Sig: sha256=...

{
  "event": "invoice.paid",
  "invoice_id": "7a4f...",
  "status": "paid",
  "amount": "149.00",
  "received": "149.00",
  "currency": "USDT_TRC20"
}

События

invoice.created Счёт создан.

invoice.waiting_confirmations Транзакция найдена.

invoice.paid Оплачено полностью.

invoice.underpaid Получено меньше суммы.

invoice.expired Время вышло / отменено.

Проверка подписи

Каждый webhook подписан HMAC-SHA256. Проверяйте заголовок X-Crynova-Sig.

$sig = 'sha256=' . hash_hmac(
    'sha256', $rawBody, $secret
);
if (! hash_equals($sig, $header)) {
    abort(401);
}

Готовы интегрироваться?

Создайте проект, получите API-ключ и примите первый платёж за считанные минуты.

Получить API-ключ Связаться с поддержкой