---
title: "Документация"
url: "https://docs.x-hub.online/"
description: "Что такое X-Hub, что получает мерчант и из чего состоит интеграция."
relatedDocuments:
  - "https://docs.x-hub.online/start/quickstart/"
  - "https://docs.x-hub.online/start/auth/"
  - "https://docs.x-hub.online/start/sandbox/"
  - "https://docs.x-hub.online/payments/"
  - "https://docs.x-hub.online/payments/errors/"
  - "https://docs.x-hub.online/payments/refunds/"
  - "https://docs.x-hub.online/webhooks/"
  - "https://docs.x-hub.online/webhooks/delivery/"
  - "https://docs.x-hub.online/subscriptions/"
  - "https://docs.x-hub.online/subscriptions/api/"
  - "https://docs.x-hub.online/subscriptions/manage/"
  - "https://docs.x-hub.online/money/balance/"
  - "https://docs.x-hub.online/money/withdrawals/"
  - "https://docs.x-hub.online/exchange/"
  - "https://docs.x-hub.online/exchange/kyc/"
  - "https://docs.x-hub.online/reference/errors/"
  - "https://docs.x-hub.online/reference/nodejs/"
  - "https://docs.x-hub.online/reference/python/"
  - "https://docs.x-hub.online/reference/faq/"
---

# Документация

**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`) выводится из этой ставки. Договаривается при подключении |

## Карта документации { #map }

**Начало**

- [Быстрый старт](start/quickstart.md) — первый платёж за пять шагов: ключи, создание платежа, QR, вебхук
- [Авторизация](start/auth.md) — заголовки, идемпотентность и лимиты запросов
- [Песочница](start/sandbox.md) — тестовый режим, симуляция статусов, чем он отличается от боя

**Платежи**

- [Платежи](payments/index.md) — создание платежа по СБП, чтение статуса и список платежей
- [Ошибки платежей](payments/errors.md) — отмены, истечение срока, несовпадение суммы и коды отказа
- [Возвраты](payments/refunds.md) — заявка на возврат, её исход и что списывается с баланса

**Уведомления**

- [Уведомления](webhooks/index.md) — требования к приёмнику, формат уведомления и проверка подписи
- [Доставка уведомлений](webhooks/delivery.md) — повторы доставки, идемпотентность и чеклист приёмника

**Подписки**

- [Подписки](subscriptions/index.md) — рекуррентные платежи: термины, общий поток, жизненный цикл
- [Ручки подписок](subscriptions/api.md) — создание, чтение, изменение подписки и списания по ней
- [Управление подпиской](subscriptions/manage.md) — пауза, возобновление, отмена, уведомления

**Деньги**

- [Баланс и курс](money/balance.md) — баланс мерчанта и как читается эффективный курс
- [Выплаты](money/withdrawals.md) — автоматические выплаты в USDT и их расписание

**Обмены**

- [Обмены](exchange/index.md) — создание обмена, статусы и работа с клиентами обмена
- [Проверка клиента](exchange/kyc.md) — подача документов, статусы и повторная подача после отказа

**Справка**

- [Коды ошибок](reference/errors.md) — все коды API и что делать по каждому
- [Пример на Node.js](reference/nodejs.md) — готовая интеграция
- [Пример на Python](reference/python.md) — готовая интеграция
- [Частые вопросы](reference/faq.md) — чеклист перед запуском

## Машинные форматы { #machine-formats }

Каждая страница отдаётся тремя способами: 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 они не могут.

---