10. Кейсы и примеры¶
Кейс 1: Полный flow транзакции¶
**
Сценарий:
**
Пользователь MoonPay в Бишкеке покупает 100 USDT за KGS.
**
Шаг 1.
**
Пользователь открывает MoonPay → выбирает Buy USDT → вводит сумму → выбирает KGS
**
Шаг 2.
**
MoonPay отправляет запрос к Twin Bridge API:
GET /v1/quotes?from=KGS&to=USDT&amount=100
**
Шаг 3.
**
Rate Engine опрашивает 10 обменников за 50-200ms:
• TokenSpot: 89.50 KGS/USDT (лимит $50K, скорость 2 мин)
• BitRuby: 89.30 KGS/USDT (лимит $20K, скорость 5 мин)
• Coin Nomad: 89.70 KGS/USDT (лимит $100K, скорость 1 мин)
• ... ещё 7 обменников
**
Шаг 4.
**
Умная маршрутизация (англ. Smart routing) выбирает BitRuby (лучший курс 89.30). Наш курс клиенту: 89.50 (спред 0.22%)
**
Шаг 5.
**
Ответ MoonPay:
{"rate": 89.50, "amount_fiat": 8950, "amount_crypto": 100, "quote_id": "TB-123", "expires": 60}
**
Шаг 6.
**
Пользователь подтверждает → MoonPay:
POST /v1/orders
с KYC данными
**
Шаг 7.
**
Twin Bridge передаёт KYC данные BitRuby (pass-through, зашифрованные)
**
Шаг 8.
**
BitRuby создаёт ордер → генерирует реквизиты для оплаты в KGS
**
Шаг 9.
**
Пользователь оплачивает 8,930 KGS через банковский перевод / Элсом / О!Деньги
**
Шаг 10.
**
BitRuby подтверждает получение KGS → отправляет 100 USDT на кошелёк пользователя
**
Шаг 11.
**
Twin Bridge получает webhook от BitRuby: order completed
**
Шаг 12.
**
Twin Bridge уведомляет MoonPay:
{"status": "completed", "tx_hash": "0x..."}
**
Шаг 13.
**
Settlement: BitRuby переводит Twin Bridge комиссию (0.22% × 8,930 = 19.6 KGS ≈ $0.22)
**
Итого:
**
Время: 3-10 мин. Комиссия TB: $0.22. При 1000 таких транзакций/день = $220/день = $6,600/мес.
Кейс 2: Как MoonPay подключает новый регион¶
** Процесс MoonPay (их сторона): ** 1. ** Market assessment: ** Объём рынка, регулирование, спрос пользователей 2. ** Partner search: ** Ищут локального партнёра с фиатными рельсами и лицензией 3. ** Due diligence: ** KYC/AML проверка партнёра, compliance review (2-4 недели) 4. ** Technical integration: ** API подключение, тестирование (2-4 недели) 5. ** Legal: ** Partnership agreement, data processing agreement (2-3 недели) 6. ** Go-live: ** Soft launch → 100% rollout ** Что мы должны предоставить: ** ☐ Company registration + AML policy document ☐ API documentation (OpenAPI 3.0 spec) ☐ Sandbox environment с тестовыми данными ☐ Coverage map: какие валюты, какие крипто, лимиты ☐ KYC flow description (как данные проходят через нас к обменнику) ☐ Settlement terms (T+0/T+1, валюта, реквизиты) ☐ Insurance / liability terms ☐ Incident response plan
Кейс 3: Санкционный удар — план действий¶
** Сценарий: ** OFAC добавляет 3 КР обменника в SDN list за обслуживание RUB-транзакций. ** T+0 (автоматически): ** • SDN screening система детектирует совпадение • Автоматический kill switch: отключение 3 обменников из Rate Engine • Alert в Slack + SMS CTO ** T+1 час: ** • Оценка: какой % объёма шёл через эти 3 обменника • Перераспределение на оставшиеся обменники • Уведомление провайдерам: "Temporary rate adjustment, all transactions routing through compliant partners" ** T+24 часа: ** • Юридическая оценка: затрагивает ли нас напрямую? • Если да → отключение всех RUB-маршрутов • Если нет → продолжаем через compliant обменников ** T+7 дней: ** • Ускоренное подключение KZT обменников (pre-signed LOI) • Обновление coverage map для провайдеров • Пересмотр финансовой модели
Кейс 4: Обменник упал — Fallback Routing¶
** Сценарий: ** TokenSpot (основной обменник, 40% объёма) — API не отвечает. ** T+0 сек: ** Health check детектирует timeout (3 consecutive failures) ** T+5 сек: ** Rate Engine автоматически исключает TokenSpot из маршрутизации ** T+5 сек: ** Следующий запрос идёт на BitRuby (второй по курсу) ** T+10 сек: ** Alert в мониторинг: "TokenSpot DOWN, fallback active" ** T+30 мин: ** Если не восстановился → ручная проверка, звонок обменнику ** T+2 часа: ** Если не восстановился → перераспределение SLA нагрузки ** Влияние: ** Спред может вырасти на 0.05-0.1% (курс BitRuby хуже). Провайдер видит немного другой курс, но транзакции идут без перебоя. Downtime для конечного пользователя: ** 0 секунд ** .
Кейс 5: Арбитражная ситуация¶
** Сценарий: ** На рынке возник спред между обменниками. • TokenSpot продаёт USDT по 89.00 KGS • Coin Nomad продаёт USDT по 90.50 KGS • Разница: 1.5 KGS (1.7%) ** Как Rate Engine использует это: ** 1. Для on-ramp (покупка USDT): маршрутизация на TokenSpot (89.00) — клиент получает лучший курс 2. Наш курс провайдеру: 89.50 → наш спред: 0.56% 3. Обычный спред: 0.2-0.25%. В арбитражной ситуации: 0.5-0.6% ** Важно: ** Мы НЕ занимаемся арбитражем (покупаем на одном, продаём на другом). Мы просто маршрутизируем к лучшему курсу. Но разница между обменниками увеличивает наш take rate органически. Twin Bridge Team Handbook · ASYSTEM · Февраль 2026 · Конфиденциально