BBAdapterBBAdapter — единый HMAC-API поверх СБП, SEPA, Stripe, Wise, TRC-20, ERC-20. С KYC iframe, KYT-screening, тройным ledger-учётом, automatic webhook'ами и rate-lock котировками.
Стандарт интеграции для бирж, кошельков, обменников, fintech, igaming и e-commerce России.
inv_8KqQh2pT9vR3TRX...4F2cНа скриншотах — настоящий ЛК Bitbanker: счета, карты, обмен, KYC, транзакции, активы. Это та самая инфраструктура, к которой подключается твой backend через BBAdapter.
Биржам, обменникам, кошелькам, igaming-платформам, fintech и e-commerce не нужно интегрироваться с НСПК, KYC, KYT, нодами Tron / Ethereum и SEPA-PSP по отдельности. BBAdapter инкапсулирует всё это и даёт одну подписанную HMAC API-поверхность.
8 типов B2B2C-партнёров. Под каждый — индивидуальная цепочка вызовов API, набор используемых рейлов, sequence-диаграмма с акторами и оценкой тайминга от bootstrap до webhook'а партнёру. Жми «Запустить флоу» — и смотри, как mock-API проходит весь путь в реальном времени.
Один merchant_token, динамические QR на каждый депозит, тройной учёт в твоём ledger'е, on-chain settle по запросу.
POST /v1/partners/bootstrapПолучаешь merchant_token — статический QR-«фон», под который генерятся тысячи динамических QR.
У биржи уже своя KYC-БД. Используем твой external_user_id как идемпотентный ключ.
POST /v1/qr24/sessionsКаждый external_invoice_id — отдельный динамический QR под общим merchant_token.
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
}Bitbanker фиксирует поступление, мы атомарно пишем 3 кредита и 2 дебета в ledger.
POST /v1/settlementsБиржа аккумулирует USDT во внутреннем балансе. Settle делает batch'ом — раз в сутки или по триггеру.
Bull-очередь раз в N минут пакует USDT в settlement-batch и отправляет.
POST /v1/qr24/sessions
{
"merchant_token": "mt_rapira_main",
"external_invoice_id": "exch_dep_8412",
"amount_rub": 50000,
"user_id": "user_298"
}{
"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
}
}Каждый event подписан HMAC-SHA256, имеет ±5 мин replay-окно и до 5 retries с exp.backoff. DLQ доступна через admin UI.
qr_session.createdqr_session.paidinvoice.creditedsettlement.batch_createdsettlement.completedКаждый адаптер — production-ready: реальные тестнеты блокчейнов, реальные банковские mock'и, реальные эмуляторы карт. Кликни, чтобы развернуть.
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"}'Реальные ставки маржи из api_keys.partner_margin_pct и средние чеки по 8 типам интеграции. Покрутишь параметры — увидишь свою кривую.
Все компоненты считаются в каждом invoice.paid webhook'е: partner_fx_margin_usdt, swap_fee_usdt, payout_fee_usdt. Прозрачность 100%.
Каждый запрос проходит криптографическую валидацию, каждый партнёр изолирован на уровне БД, каждый payout сверяется с Chainalysis. Безопасность — архитектурное свойство, а не post-hoc патч.
На каждый запрос: подпись body + timestamp + nonce. Replay-окно ±5 минут.
Row-Level Security между партнёрами. Один SQL-запрос видит только свои данные.
Паспорта, ИНН, телефоны — отдельная зашифрованная таблица с rotated DEK.
Idempotency-Key на 24 часа, exact-once семантика для платёжных операций.
Pre-screen каждого on-chain payout. high-risk → автоматический отказ + audit.
WORM-таблица всех state-transitions, retention 5 лет под требования 152-ФЗ.
Архитектура спроектирована под российский контур: всё разворачивается внутри инфраструктуры партнёра или в Yandex.Cloud / VK Cloud / Selectel без пересечения границы.
Цифры — не маркетинговые. Они зафиксированы в SLA-приложении к договору и привязаны к финансовому штрафу при превышении.
Активный мониторинг 24/7. Status-page с историческими инцидентами.
От зачисления СБП до on-chain подтверждения TRC-20 на адресе клиента.
Exp.backoff 1–60 минут, Postgres-DLQ, ручной replay из admin UI.
Premium-tier — выделенный Slack-канал с инженерами integrations-команды.
Не нужно ставить sandbox самому, разбираться в настройках и подписывать ключи. Оставьте заявку — менеджер сам соберёт пакет под ваш объём, юрисдикцию и сроки. Sandbox + production-доступ открываем мы, на готовое.
Менеджер интеграций ответит в течение 1 рабочего дня и предложит конфигурацию из 9 продуктов под ваш профиль.
Head of Integrations · Bitbanker. Отвечает в течение 1 часа в рабочее время.
@rudnevalexГолосом — быстрее всего обсудить нестандартный кейс или защищённую сделку.
+7 (929) 958-58-60Для документов, NDA, формальных запросов и проверки безопасности.
rudnev@bitbanker.org