Розробникам

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-ключ Звʼязатися з підтримкою