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

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 минут.

Связанные страницы