Документация
X-Hub — платёжный шлюз для B2B-мерчантов. Принимаем рубли от российских клиентов через СБП, рассчитываемся с вами в USDT ежедневно в 12:00 по московскому времени — за платежи предыдущих суток.
Base URL: https://api.x-hub.online/api/v1
Что получает мерчант
- Приём платежей СБП без юр.лица в РФ
- USDT → RUB обмены для обменников (клиент шлёт USDT, получает RUB на карту)
- Автоматические ежедневные выплаты USDT (TRC20) на твой кошелёк
- Webhook-уведомления о каждом изменении статуса
- Идемпотентность, HMAC-подпись, ретраи из коробки
- Курс зачисления фиксируется один раз на весь ежедневный расчёт (T+1 settlement, 12:00 МСК)
Ключевые концепции
| Термин | Что это |
|---|---|
| Payment | Заявка на приём рублей. Создаётся тобой, оплачивается клиентом через СБП |
| Exchange | Обмен USDT → RUB. Клиент шлёт USDT, получает RUB на карту по СБП |
| Webhook | HTTP POST от X-Hub на твой URL при изменении статуса платежа/обмена |
| Settlement | Ежедневная (12:00 МСК) конвертация pending RUB → available USDT по курсу, зафиксированному на весь расчёт |
| Withdrawal | Автоматическая выплата USDT с баланса на твой кошелёк — происходит сама, без запросов с твоей стороны |
| Markup | Процент, который X-Hub удерживает из суммы платежа: тебе начисляется amount_usdt = валовая сумма в USDT × (1 − markup/100). Курс мерчанта (rate_merchant) выводится из этой ставки. Договаривается при подключении |
Карта документации
Начало
- Быстрый старт — первый платёж за пять шагов: ключи, создание платежа, QR, вебхук
- Авторизация — заголовки, идемпотентность и лимиты запросов
- Песочница — тестовый режим, симуляция статусов, чем он отличается от боя
Платежи
- Платежи — создание платежа по СБП, чтение статуса и список платежей
- Ошибки платежей — отмены, истечение срока, несовпадение суммы и коды отказа
- Возвраты — заявка на возврат, её исход и что списывается с баланса
Уведомления
- Уведомления — требования к приёмнику, формат уведомления и проверка подписи
- Доставка уведомлений — повторы доставки, идемпотентность и чеклист приёмника
Подписки
- Подписки — рекуррентные платежи: термины, общий поток, жизненный цикл
- Ручки подписок — создание, чтение, изменение подписки и списания по ней
- Управление подпиской — пауза, возобновление, отмена, уведомления
Деньги
- Баланс и курс — баланс мерчанта и как читается эффективный курс
- Выплаты — автоматические выплаты в USDT и их расписание
Обмены
- Обмены — создание обмена, статусы и работа с клиентами обмена
- Проверка клиента — подача документов, статусы и повторная подача после отказа
Справка
- Коды ошибок — все коды API и что делать по каждому
- Пример на Node.js — готовая интеграция
- Пример на Python — готовая интеграция
- Частые вопросы — чеклист перед запуском
Машинные форматы
Каждая страница отдаётся тремя способами: HTML для человека, .md для программы и — там, где есть ручки — schema.json с фрагментом OpenAPI 3.1.
https://docs.x-hub.online/payments/ HTML
https://docs.x-hub.online/payments.md маркдаун с шапкой
https://docs.x-hub.online/payments/schema.json тело запроса и авторизация
https://docs.x-hub.online/llms.txt список всех страниц
Схемы генерируются из боевого кода, а не пишутся отдельно, — разойтись с API они не могут.