Разработчикам
API криптоплатежей
Три метода: создать счёт, узнать статус, узнать баланс. Клиент платит на странице оплаты, а вы получаете вебхук и USDT.
Методы
| Метод | Что делает |
|---|---|
POST /api/v1/payments | Создать счёт и получить ссылку на страницу оплаты |
GET /api/v1/payments/{uuid} | Статус, адрес и идентификатор транзакции |
GET /api/v1/wallet | Доступный и замороженный баланс USDT |
Базовый адрес: https://api.crybit.net · JSON · 60 запросов в минуту · авторизация: заголовки X-Public-Key и X-Private-Key.
Создание счёта
Обязательны только amount и currency. Передайте свой order_id, чтобы сопоставить платёж с заказом, и ttl_minutes, чтобы задать срок жизни.
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"}'JavaScript
const invoice = await fetch('https://api.crybit.net/api/v1/payments', {
method: 'POST',
headers: {
'X-Public-Key': 'pk_…',
'X-Private-Key': 'sk_…',
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ amount: 1490, currency: 'RUB', order_id: 'ORD-1048' }),
}).then((r) => r.json())
location.href = invoice.callback_url // the payment pageВебхуки и виджет
Когда счёт оплачен, CryBit вызывает вебхук вашего мерчанта, и вы можете выдавать заказ. Чтобы клиент остался на вашем сайте, запросите confirmation типа embedded и откройте форму оплаты скриптом виджета.
Справочник
Вопросы и ответы
Как авторизоваться?
Передавайте публичный ключ в X-Public-Key, а приватный в X-Private-Key. Нужны оба заголовка. Мерчант определяется по публичному ключу, поэтому shop_id в запросе не нужен.
Есть ли тестовый режим?
Да. Мерчант в тестовом режиме создаёт тестовые счета: на странице оплаты есть кнопка «Отметить оплаченным», а баланс они не меняют. Переведите мерчанта в боевой режим, чтобы принимать реальные переводы.
Какие ограничения?
API принимает 60 запросов в минуту на ключ. Сумма счёта — от 0,01, срок жизни — от 5 до 1440 минут.
