Розробникам
Створіть рахунок
Один запит POST створює рахунок і повертає посилання на сторінку оплати. Там клієнт обирає монету й мережу.
Запит
curl
curl -X POST https://api.crybit.net/api/v1/payments \
-H "X-Public-Key: pk_…" \
-H "X-Private-Key: sk_…" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"amount":1490,"currency":"RUB","order_id":"ORD-1048","purpose":"Order 1048"}'| Поле | Значення |
|---|---|
amount | Обов’язкове. Число від 0.01. Існує мінімум в USDT, бо комісія мережі не може перевищувати суму рахунку, коли її сплачує мерчант: поточний мінімум можна дізнатися через GET /api/payments/quote. |
currency | Обов’язкове. Фіат (RUB, USD, EUR, CNY, GBP, CHF, JPY, KZT та інші основні валюти) або USDT/USDC. Суму конвертують за поточним курсом. |
order_id | Ваш власний ID замовлення, до 80 символів. Якщо порожнє, CryBit генерує CB-…. |
purpose | Опис, до 240 символів. |
ttl_minutes | Термін дії від 5 до 1440 хвилин, за замовчуванням 30. |
return_url | Куди повертається клієнт після оплати (http або https, до 500 символів). Якщо не задано, використовується return URL мерчанта. |
crypto, network | Необов’язково. Передайте обидва, щоб одразу отримати у відповіді адресу, суму та QR-код, наприклад USDT і TRC-20. |
confirmation | Необов’язково. {"type":"embedded"} для вбудованого віджета. Токен завжди є у відповіді. |
Відповідь
Відповідь має код 201 і містить об’єкт рахунку. Спрямуйте клієнта на callback_url (сторінку оплати). Без crypto і network значення needs_method дорівнює true, і клієнт обирає на цій сторінці.
JSON
{
"uuid": "28d0ff38-949c-435e-ad41-c81c219b3597",
"order_id": "ORD-1048",
"amount": 1490,
"currency": "RUB",
"status": "waiting",
"sandbox": true,
"needs_method": true,
"callback_url": "https://pay.crybit.net/28d0ff38-949c-435e-ad41-c81c219b3597",
"confirmation": { "type": "embedded", "confirmation_token": "28d0ff38-…", "widget_url": "https://pay.crybit.net/widget.js" },
"expires_at": "2026-09-21T13:41:42+00:00"
}Статус
GET /api/v1/payments/{uuid} повертає той самий об’єкт. Статус: waiting, paid, expired або cancelled. Після того як клієнт обере мережу, в об’єкті з’являються crypto, network, address і комісія; після оплати — status paid, txid і paid_at. Рахунок waiting із простроченим терміном дії стає expired, коли ви його запитуєте. fee_payer має значення shop, коли комісію сплачує мерчант, і buyer, коли сума до сплати вже її включає.
Вопросы и ответы
Які заголовки надсилати?
X-Public-Key і X-Private-Key, обидва обов’язкові. Відсутній, неправильний або застарілий приватний ключ повертає 401.
Чи є ліміт запитів?
60 запитів на хвилину на ключ.