BitbankerBBAdapter
v1.0 · prod-ready · 7 рейлов

Один API. 7 платёжных рейлов. ₽ → USDT за 47 секунд.

BBAdapter — единый HMAC-API поверх СБП, SEPA, Stripe, Wise, TRC-20, ERC-20. С KYC iframe, KYT-screening, тройным ledger-учётом, automatic webhook'ами и rate-lock котировками.

Стандарт интеграции для бирж, кошельков, обменников, fintech, igaming и e-commerce России.

Адаптеров
7
Эндпоинтов
11
paid → USDT
47с
Маржа партнёра
0,7–1,25%
LIVE
inv_8KqQh2pT9vR3
СБП
Партнёр
Rapira-like
exchange
RUB → USDT
50 000 $497.50
fx: 100.50recipient: TRX...4F2c
Pipeline
0%
Created
Paid
KYT
Settled
Events
bootstrapping…
7 рейлов
СБПSEPAStripeWiseTronETH
Реальный продукт · не моки

За BBAdapter стоит живая платформа Bitbanker, уже работающая в проде

На скриншотах — настоящий ЛК Bitbanker: счета, карты, обмен, KYC, транзакции, активы. Это та самая инфраструктура, к которой подключается твой backend через BBAdapter.

  • Web-клиент на Apollo Federation + 25 микросервисов
  • Backoffice (admin, KYT, VABS, тарифы) — 5 отдельных приложений
  • iOS/Android · Bitbanker + Index Wallet (React Native)
  • Theme switcher, ru/en, multi-currency из коробки
bb-product-tour /flows/main/state-c
Зачем

7 рейлов своими руками — это 6 месяцев и 15 млн ₽. BBAdapter — одна интеграция за неделю.

Биржам, обменникам, кошелькам, igaming-платформам, fintech и e-commerce не нужно интегрироваться с НСПК, KYC, KYT, нодами Tron / Ethereum и SEPA-PSP по отдельности. BBAdapter инкапсулирует всё это и даёт одну подписанную HMAC API-поверхность.

Без BBAdapter

  • 7 интеграций × 6 месяцев каждая
    СБП через банк-партнёра, Stripe, SEPA-PSP, ноды Tron / Ethereum, KYC-провайдер, KYT-сервис, Chainalysis. Каждый — отдельный договор, отдельный комплаенс, отдельные ключи.
  • ≈ 15 млн ₽ только на инфраструктуру
    5 разработчиков × 6 месяцев на каждый рейл, лицензии KYC/KYT, инфраструктура нод, юристы. И это до первого живого платежа.
  • Хрупкая цепочка событий
    paid → swap → KYT → payout легко рвётся при рестарте сервиса, retry-логику пишет каждый сам, webhook-DLQ редко кто делает в первый год.

С BBAdapter

  • Один HMAC-API на 7 рейлов
    Поднимаешь sandbox через docker compose up -d за 5 минут. Та же поверхность API уезжает в prod без изменений в коде.
  • Прод за неделю, не за полгода
    Bootstrap-endpoint выдаёт api_key + webhook_secret, готовая Postman-коллекция, SDK на TypeScript / Python, docs со Swagger TryItOut.
  • Durable async pipeline из коробки
    Bull-очереди с 5 retries и exp.backoff, webhook-DLQ как Postgres-таблица, ручной replay из admin UI, идемпотентность по RFC.
Время до прода
6 мес1 нед
CapEx
≈ 15M ₽≈ 300K ₽
Команда
5 разраб.1 разраб.
Конструктор · interactive

Выбери свой профиль — получи готовый сценарий интеграции.

8 типов B2B2C-партнёров. Под каждый — индивидуальная цепочка вызовов API, набор используемых рейлов, sequence-диаграмма с акторами и оценкой тайминга от bootstrap до webhook'а партнёру. Жми «Запустить флоу» — и смотри, как mock-API проходит весь путь в реальном времени.

Шаг 1 · Тип бизнеса
Шаг 2 · Готовый сценарий

Биржа (Rapira-like)

Один merchant_token, динамические QR на каждый депозит, тройной учёт в твоём ledger'е, on-chain settle по запросу.

QR24 dynamicвнутренний балансon-chain settle
Шагов
6
Total
12,8 с
Маржа
1,15%
Задействованные рейлы
СБП
Tron · TRC-20
Ethereum · ERC-20
Live-симуляция · моки
Пауза
0 мс/12 770 мс
  1. 1
    Bootstrap биржи
    Партнёр
    ~100 мс
  2. 2
    KYC уже на твоей стороне
    Партнёр
    ~0 мс
  3. 3
    Динамический QR24 на депозит
    BBAdapter
    ~110 мс
  4. 4
    Клиент платит, тройной учёт
    BBAdapter
    ~4,0 с
  5. 5
    Запрос вывода (по cron / on-demand)
    Партнёр
    ~175 мс
  6. 6
    On-chain settlement
    Блокчейн
    ~2,0 с
api.bbadapter.bitbanker.ru · live mock
Жми Запустить флоу — здесь побегут реальные API-вызовы из выбранного сценария.
Sequence · 6 шагов
12 сек end-to-end
  1. 1
    Bootstrap биржи
    Партнёр
    200 мс
    POST /v1/partners/bootstrap

    Получаешь merchant_token — статический QR-«фон», под который генерятся тысячи динамических QR.

    • Что получаешь
      merchant_token, api_key, webhook_secret. Один merchant_token = один корпоративный счёт у Bitbanker.
  2. 2
    KYC уже на твоей стороне
    Партнёр

    У биржи уже своя KYC-БД. Используем твой external_user_id как идемпотентный ключ.

    • Что делаешь
      Передаёшь user_kyc_token (твой ID) — мы не запрашиваем паспорт повторно.
    • Что приходит
      Если новый клиент — выдаёшь iframe KYC сам. Если уже верифицирован — сразу шаг 3.
  3. 3
    Динамический QR24 на депозит
    BBAdapter
    220 мс
    POST /v1/qr24/sessions

    Каждый external_invoice_id — отдельный динамический QR под общим merchant_token.

    • Что делаешь
      POST с amount_rub, external_invoice_id, user_id. Получаешь qr_session_id и payment_url.
    • Что приходит
      QR валиден 30 минут. Один QR — одна сумма. Перевып покупателем приведёт к идемпотентному ответу.
    POST /v1/qr24/sessions
    {
      "external_invoice_id": "exch_dep_8412",
      "merchant_token": "mt_rapira_main",
      "amount_rub": 50000,
      "user_id": "user_298",
      "ttl_seconds": 1800
    }
  4. 4
    Клиент платит, тройной учёт
    BBAdapter
    8,0 с

    Bitbanker фиксирует поступление, мы атомарно пишем 3 кредита и 2 дебета в ledger.

    • Что происходит автоматически
      1) +RUB на счёт биржи (внутренний). 2) -RUB → +USDT через swap. 3) +partner_fee на счёт биржи. 4) Запись в ledger с external_invoice_id.
    • Что приходит
      Webhook invoice.credited с разложением. Биржа кредитит баланс пользователя на своей стороне.
  5. 5
    Запрос вывода (по cron / on-demand)
    Партнёр
    350 мс
    POST /v1/settlements

    Биржа аккумулирует USDT во внутреннем балансе. Settle делает batch'ом — раз в сутки или по триггеру.

    • Что делаешь
      POST /v1/settlements — настраиваешь auto / hold / manual режим.
    • Что приходит
      settlement.batch_created → череда on-chain переводов на холодные кошельки биржи.
  6. 6
    On-chain settlement
    Блокчейн
    4,0 с

    Bull-очередь раз в N минут пакует USDT в settlement-batch и отправляет.

    • Что делаем мы
      Сжимаем N депозитов в одну транзакцию (если возможно), пишем tx_hash в каждый ledger-entry.
    • Что приходит
      settlement.completed с массивом tx_hashes и amounts. Comma-separated CSV для бухгалтерии.
Шаг 3 · Реальный payload (request → response)
Request
POST /v1/qr24/sessions
{
  "merchant_token": "mt_rapira_main",
  "external_invoice_id": "exch_dep_8412",
  "amount_rub": 50000,
  "user_id": "user_298"
}
Response
{
  "qr_session_id": "qr_8KqQ...",
  "payment_url": "https://qr.nspk.ru/dyn/...",
  "expires_at": "2026-05-05T18:42:18Z",
  "fees_preview": {
    "sbp_commission_rub": 600,
    "fx_margin_usdt": 5.75
  }
}
Шаг 4 · Какие webhook'и придут

Каждый event подписан HMAC-SHA256, имеет ±5 мин replay-окно и до 5 retries с exp.backoff. DLQ доступна через admin UI.

qr_session.createdqr_session.paidinvoice.creditedsettlement.batch_createdsettlement.completed

Готов попробовать на своих цифрах?

Калькулятор маржиПоднять sandbox
7 рейлов

7 готовых коннекторов — один HMAC-API

Каждый адаптер — production-ready: реальные тестнеты блокчейнов, реальные банковские mock'и, реальные эмуляторы карт. Кликни, чтобы развернуть.

Возможности
  • Динамические и статические QR
  • Push-уведомления через ЦБ РФ
  • Возвраты в исходный банк
  • 152-ФЗ data residency
Endpoint
POST /v1/invoices
Комиссия
0,4–0,7% B2C · фикс 7 ₽ B2B
curl -X POST https://api.bua.bitbanker.ru/v1/invoices \
  -H "X-Partner-Key: ${KEY}" \
  -H "X-Signature: ${HMAC}" \
  -d '{"rail":"sbp","amount_rub":10000,"external_id":"order-42"}'
Калькулятор прибыли

Сколько ты заработаешь за 12 месяцев

Реальные ставки маржи из api_keys.partner_margin_pct и средние чеки по 8 типам интеграции. Покрутишь параметры — увидишь свою кривую.

Тип бизнеса
Месячный объём
100 млн ₽
5 млн ₽100 млн ₽2 млрд ₽
Средний чек
+0% · 10 000
Эффективная маржа
1,15%
Результаты
Год
$138,696
Маржа в USDT / мес
$11,558
Эфф. ставка
1,15%
Эквайринг ₽ / мес
1 200 000
Операций / мес
~10 000
Прогноз 12 мес (USDT)
с учётом сезонности рынка
+44% Q1→Q4
1
2
3
4
5
6
7
8
9
10
11
12

Все компоненты считаются в каждом invoice.paid webhook'е: partner_fx_margin_usdt, swap_fee_usdt, payout_fee_usdt. Прозрачность 100%.

Безопасность

6 слоёв защиты — от подписи запроса до chain-скрининга.

Каждый запрос проходит криптографическую валидацию, каждый партнёр изолирован на уровне БД, каждый payout сверяется с Chainalysis. Безопасность — архитектурное свойство, а не post-hoc патч.

HMAC-SHA256

На каждый запрос: подпись body + timestamp + nonce. Replay-окно ±5 минут.

RLS Postgres

Row-Level Security между партнёрами. Один SQL-запрос видит только свои данные.

AES-256-GCM PII vault

Паспорта, ИНН, телефоны — отдельная зашифрованная таблица с rotated DEK.

Idempotency RFC

Idempotency-Key на 24 часа, exact-once семантика для платёжных операций.

Chainalysis KYT

Pre-screen каждого on-chain payout. high-risk → автоматический отказ + audit.

Immutable audit log

WORM-таблица всех state-transitions, retention 5 лет под требования 152-ФЗ.

Технологический стек

Open-source стек. Никаких иностранных PaaS, никаких vendor-lock'ов.

Архитектура спроектирована под российский контур: всё разворачивается внутри инфраструктуры партнёра или в Yandex.Cloud / VK Cloud / Selectel без пересечения границы.

Runtime

  • NestJS 10
  • Node.js 20 LTS
  • TypeScript 5
  • Bull queues

Storage

  • PostgreSQL 16
  • Redis 7
  • S3-compatible (MinIO)
  • Litestream backup

Деплой

  • Docker Compose
  • Kubernetes (опц.)
  • Yandex.Cloud / VK / Selectel
  • Blue-green release

Observability

  • Prometheus + Grafana
  • OpenTelemetry traces
  • Loki structured logs
  • Sentry error tracking

Качество

  • 100+ unit tests
  • smoke + e2e Playwright
  • OpenAPI 3.1 контракт-тесты
  • Postman pre-built

Production performance

  • p95 latency< 80 мс
  • RPS на ноду5 000+
  • DB poolPgBouncer
  • Webhook retry5x exp.backoff
SLA · Operations

Production-grade SLA с обязательствами на бумаге.

Цифры — не маркетинговые. Они зафиксированы в SLA-приложении к договору и привязаны к финансовому штрафу при превышении.

99,95%
Uptime

Активный мониторинг 24/7. Status-page с историческими инцидентами.

47 с
Медиана paid → USDT

От зачисления СБП до on-chain подтверждения TRC-20 на адресе клиента.

5x retry
Webhook delivery

Exp.backoff 1–60 минут, Postgres-DLQ, ручной replay из admin UI.

≤ 1 ч
Time-to-first-response

Premium-tier — выделенный Slack-канал с инженерами integrations-команды.

Принимаем заявки · собираем под ключ

Соберём BBAdapter под ваш кейс

Не нужно ставить sandbox самому, разбираться в настройках и подписывать ключи. Оставьте заявку — менеджер сам соберёт пакет под ваш объём, юрисдикцию и сроки. Sandbox + production-доступ открываем мы, на готовое.

Расскажите о своём кейсе

Менеджер интеграций ответит в течение 1 рабочего дня и предложит конфигурацию из 9 продуктов под ваш профиль.

Ответим в течение 1 рабочего дня · соберём под ключ под ваш кейс

Telegram — Александр Руднев
рекомендуем

Head of Integrations · Bitbanker. Отвечает в течение 1 часа в рабочее время.

@rudnevalex
Звонок

Голосом — быстрее всего обсудить нестандартный кейс или защищённую сделку.

+7 (929) 958-58-60
Email

Для документов, NDA, формальных запросов и проверки безопасности.

rudnev@bitbanker.org
Что будет дальше
  1. 1Связываемся в течение 1 рабочего дня
  2. 230-минутный созвон: диагностируем кейс и собираем пакет
  3. 3Демо платформы под ваш сценарий и КП
  4. 4После NDA — тестовый доступ и план интеграции