Разработка системы управления крипто-картой
Отметим: когда пользователь хочет платить криптовалютой в обычном магазине, возникает сложная цепочка: конвертация, авторизация, settlement — и всё за 1–2 секунды. Мы построили не одну такую систему и знаем каждый подводный камень: от выбора card issuing провайдера до real-time webhook-обработчика. В этом материале — архитектура, которая работает в продакшене.
Крипто-карта — это мост между on-chain активами и традиционной платёжной инфраструктурой. Пользователь держит USDC, платит в обычном магазине — система конвертирует и списывает в фоне. Построить это сложнее, чем кажется: здесь пересекаются card issuing, real-time конвертация, compliance, и блокчейн-инфраструктура. Мы реализовали такие системы для neobank-стартапов и crypto-native платформ, столкнувшись с нюансами batch settlement, форс-мажорами oracle и юридическими требованиями в юрисдикциях ЕС и США. Ниже — детали, сэкономившие месяцы разработки. Если вам нужна подобная система — свяжитесь с нами для консультации.
Card Issuing: с кем работать
Самостоятельно получить BIN спонсора и эмитировать карты — долго и дорого: партнёрство с Visa/Mastercard требует значительного депозита и занимает 12–18 месяцев. Реалистичный путь — работать через card issuing платформы:
- Marqeta — лидер рынка, программируемые карты через Just-in-Time (JIT) Funding. Ключевая фича: при каждой авторизации Marqeta делает webhook на ваш сервер, вы решаете — одобрить или отклонить и мгновенно фондируете транзакцию. Идеально для крипто-карт.
- Lithic (бывш. Privacy) — аналог Marqeta, часто предпочтительнее для стартапов из-за более простого onboarding.
- Moorwand / Railsr (Европа) — для европейских карт с IBAN.
- Monavate / Paymentology — альтернативы с более гибкими условиями для crypto-native компаний.
Все эти провайдеры дают REST API для выпуска карт, управления лимитами, получения транзакций.
Механизм JIT Funding
Just-in-Time Funding — это когда баланс на карте всегда нулевой, а деньги появляются только в момент авторизации. Для крипто-карты это означает: пользователь авторизует покупку → card processor вызывает ваш webhook → вы конвертируете крипту в фиат → подтверждаете транзакцию — всё за 1–2 секунды.
Marqeta документация: "Just-in-Time Funding позволяет эмитентам контролировать каждую авторизацию в реальном времени."
Вот пошаговая последовательность обработки:
- Card processor (Marqeta, Lithic) отправляет HTTP-запрос на ваш webhook с деталями авторизации.
- Сервис определяет пользователя по card_token и проверяет доступный баланс в USDC через локальный кеш или быстрый запрос к блокчейну.
- Если средств достаточно (с учётом буфера на slippage), система резервирует сумму (soft lock) и возвращает решение APPROVE.
- После settlement (через минуты или часы) запускается реальная конвертация USDC в фиат через off-ramp провайдера.
- Баланс пользователя обновляется, отправляется push-уведомление.
Webhook должен отвечать за 1–2 секунды. Если таймаут — транзакция автоматически отклоняется. Это жёсткое требование, которое определяет всю архитектуру: никаких синхронных блокчейн операций в этом пути.
interface AuthorizationWebhook {
type: "authorization";
token: string;
card_token: string;
amount: number; // в центах
currency: string; // ISO 4217
merchant: {
descriptor: string;
mcc: string;
country: string;
};
created: string;
}
async function handleAuthorization(
webhook: AuthorizationWebhook
): Promise<AuthorizationResponse> {
// 1. Найти пользователя и его крипто-баланс
const user = await getUserByCardToken(webhook.card_token);
const requiredUsd = webhook.amount / 100;
// 2. Проверить доступный баланс в USDC
const usdcBalance = await getUsdcBalance(user.walletAddress);
if (usdcBalance < requiredUsd * 1.01) { // +1% буфер на slippage
return { decision: "DECLINE", reason: "INSUFFICIENT_FUNDS" };
}
// 3. Зарезервировать средства (soft lock)
const reservation = await reserveFunds(user.id, requiredUsd, webhook.token);
// 4. Подтвердить авторизацию
return {
decision: "APPROVE",
amount: webhook.amount,
reservation_id: reservation.id,
};
}
Settlement и реальное списание
После авторизации идёт settlement — фактическое перемещение средств. Это может происходить через минуты или часы после авторизации. Здесь выполняется реальная конвертация крипты.
async function settleTransaction(settlementData: SettlementEvent): Promise<void> {
const reservation = await getReservation(settlementData.authorization_token);
// Для USDC — просто перевести на фиатный счёт через USDC → USD off-ramp
// (Circle, Stripe Crypto, Bridge.xyz)
const offRampResult = await circleOffRamp({
amount: reservation.usdAmount,
destinationBankAccount: OPERATIONAL_ACCOUNT,
});
// Обновить баланс пользователя
await deductUserBalance(reservation.userId, reservation.usdcAmount);
// Отправить push уведомление
await sendTransactionNotification(reservation.userId, {
amount: reservation.usdAmount,
merchant: settlementData.merchant.descriptor,
txId: offRampResult.id,
});
}
Конвертация: USDC vs volatility assets
USDC/USDT — простейший случай. 1 USDC ≈ 1 USD, конвертация тривиальна. Большинство крипто-карт первого поколения работают только со стейблкоинами.
ETH/BTC и другие — нужен real-time price feed и управление ценовым риском. Варианты:
- Конвертировать в USDC при пополнении карты — пользователь явно меняет ETH → USDC, дальше всё как выше. Самый простой подход.
- Конвертировать в момент транзакции — выше риск slippage (обычно 0.5–1%) и ценового gap между авторизацией и settlement. Требует hedging стратегии.
- Виртуальный баланс + периодический settlement — агрегируете транзакции, конвертируете батчами. Снижает transaction costs, но усложняет accounting.
Почему важен правильный выбор card issuing провайдера?
Успех крипто-карты напрямую зависит от способности провайдера обрабатывать миллионы JIT Funding запросов с минимальной задержкой. Marqeta лучше для JIT Funding благодаря более детальным webhook-конфигурациям, но Lithic быстрее в интеграции для стартапов. Для европейского рынка — Moorwand или Railsr с поддержкой SEPA Instant. Ошибка на этом этапе приводит к отказам транзакций и потере доверия пользователей.
Как обеспечить compliance при выпуске крипто-карт?
Крипто-карта с реальным использованием — это финансовый продукт, регулируемый как минимум как электронные деньги. Обязательные компоненты:
- KYC/AML — провайдеры: Sumsub, Persona, Onfido. Интеграция через REST API + webhook на события верификации. Минимальный tier: документ + selfie. Для высоких лимитов — Enhanced Due Diligence (EDD). Подробнее о KYC и AML.
- Transaction monitoring — анализ on-chain истории адресов пользователей. Chainalysis API или Elliptic для проверки: не поступают ли средства с санкционных адресов, миксеров, darknet markets.
- Лимиты по умолчанию — пока KYC не пройден: например, 150 EUR/мес (под PSD2 exemption). После верификации — стандартные лимиты. Это требование card schemes, не ваша придумка.
Технический стек
| Компонент | Варианты | Рекомендация |
|---|---|---|
| Card issuing | Marqeta, Lithic | Marqeta для JIT Funding |
| Backend | Node.js/TypeScript, Go | Go для latency-sensitive webhook handler |
| База данных | PostgreSQL | + Redis для reservation locks |
| Блокчейн | Viem, ethers.js | Viem для EVM |
| Off-ramp | Circle, Bridge.xyz | Circle USDC → USD |
| KYC | Sumsub, Persona | Sumsub — лучший охват стран |
| Нотификации | Firebase, Appcenter | Firebase для push |
Webhook handler для авторизации должен работать отдельным высокодоступным сервисом с SLA 99.9%+, минимальным количеством зависимостей и локальным кешем для быстрых проверок баланса.
Сроки разработки
| Этап | MVP | Полный продукт |
|---|---|---|
| Архитектура и выбор стека | 2 недели | 1 месяц |
| Интеграция card issuing | 2–3 недели | 1–2 месяца |
| Backend (webhook + core) | 2 месяца | 5–7 месяцев |
| Off-ramp и конвертация | 3 недели | 2–3 месяца |
| KYC/AML модуль | 1 месяц | 2–3 месяца |
| Тестирование и аудит | 2 недели | 1–2 месяца |
| Юридические договоры | параллельно | 3–6 месяцев |
Что входит в разработку
- Архитектура и выбор стека под вашу бизнес-модель (B2C или B2B).
- Интеграция с card issuing провайдером, настройка JIT Funding.
- Backend на Go или Node.js с обработкой webhook-ов (latency < 1 сек).
- Подключение off-ramp (Circle, Bridge.xyz) для конвертации USDC → фиат.
- KYC/AML модуль с поддержкой Sumsub или Persona.
- Transaction monitoring, лимиты, блокировки.
- Документация API и инструкции по эксплуатации.
- Техническая поддержка на этапе запуска и первые 2 месяца после релиза.
Мы гарантируем соответствие требованиям card schemes и регуляторов. Наш опыт — 5+ лет в разработке крипто-сервисов: от кошельков до полноценных neobank решений.
Типичные ошибки при интеграции JIT Funding:
- Синхронные блокчейн вызовы в webhook-е — гарантированный таймаут.
- Отсутствие локального кеша балансов — 100мс+ задержка на каждый запрос.
- Неправильный расчёт комиссий — settlement может сгореть из-за превышения лимита.
- Игнорирование мультивалютных settlement-ов — при конвертации может возникнуть отрицательный баланс.
Свяжитесь с нами, чтобы получить индивидуальную оценку вашего проекта. Закажите разработку системы управления крипто-картой — мы подготовим предложение за 2 дня.