API выпуска карт
2328 — это API выпуска виртуальных карт для команд, которые хотят дать своим пользователям платёжную карту, не становясь лицензированным эмитентом. Вы регистрируете держателей карт, выпускаете карты под спонсируемым BIN, пополняете их со своего USDT-кошелька и управляете всем жизненным циклом — заморозка, выгрузка средств, закрытие — через один REST-интерфейс.
Классический путь к собственной карточной программе — лицензия платёжной схемы, собственный BIN, процессор, банк-спонсор и полтора года сертификации до первой авторизации. Здесь эта работа уже сделана. С вашей стороны остаётся то, что действительно является вашим продуктом: кто получает карту, сколько может тратить и как это выглядит.
API работает только с JSON, все поля в camelCase, а каждый запрос, кроме публичной проверки живости, авторизуется Bearer-ключом. Деньги — всегда целое число в минимальных единицах с явной валютой и масштабом: кошелёк — USDT с масштабом 6, карты — USD с масштабом 2 — поэтому в учёте никогда не бывает неоднозначных дробных чисел.
Держатели карт
Регистрируйте держателей с теми данными, которые требует программа, и выпускайте для каждого одну или несколько карт. Онбординг, лимиты и жизненный цикл полностью управляются с вашей стороны.
Мгновенный выпуск виртуальных карт
Карты создаются одним вызовом API и готовы к использованию сразу — без пластика, доставки и активации. Выпускайте по карте на пользователя, подписку, кампанию или поставщика.
Пополнение с USDT-кошелька
Карты пополняются с вашего баланса в стейблкоинах. USDT хранится с масштабом 6, баланс карты — USD с масштабом 2, и API явно работает с обоими, поэтому учёт никогда не расходится.
Полный контроль жизненного цикла
Замораживайте, размораживайте, выгружайте средства и закрывайте карты программно. Скомпрометированная карта блокируется одним запросом; завершённая подписка ничего не стоит закрыть.
Балансы и транзакции
Читайте актуальные балансы карт и историю транзакций по всей программе, включая авторизации, клиринг, отказы и комиссии.
Ордера и вебхуки
Денежные операции асинхронны: вы отправляете операцию, получаете ордер и считаете вебхук источником истины, а не полагаетесь на ответ 200.
Спонсорство BIN без двухлетнего обхода
Каждая карта привязана к BIN — номеру, который говорит платёжным сетям, какое лицензированное учреждение за ней стоит. Получить собственный — значит стать основным участником Visa или Mastercard: регуляторная лицензия, залог схеме, капитальные требования и годы сертификации.
Карты, выпущенные через 2328, работают на существующем спонсируемом BIN. Спонсирующее учреждение держит членство в схеме и рассчитывается с сетью; вы сохраняете продукт, брендинг, отношения с держателями карт и экономику. На практике это превращает лицензионный проект в интеграционный.
Онбординг — всё ещё настоящая проверка: у вас спросят, кто ваши держатели карт, откуда деньги и как устроены KYC и мониторинг. Чем яснее ответы, тем быстрее запускается программа.
Как проходит интеграция
- 1.Согласуйте программу: профиль держателей, схему пополнения, географию и лимиты.
- 2.Получите API-ключи и проверьте связность через публичный эндпоинт GET /ping.
- 3.Зарегистрируйте первого держателя и выпустите карту в боевой среде.
- 4.Пополните карту с USDT-кошелька и подтвердите ордер через вебхук.
- 5.Подключите балансы, транзакции и операции жизненного цикла к своему продукту.
- 6.Запускайтесь и масштабируйтесь — выпуск карты это один вызов, поэтому объёмы не проблема для разработки.
Частые вопросы
Нужна ли собственная лицензия или BIN для выпуска карт?
Нет. Карты выпускаются под существующим спонсируемым BIN, поэтому становиться основным участником Visa или Mastercard не нужно. Вы описываете держателей и схему пополнения при онбординге; лицензирование и расчёты со схемой остаются на стороне спонсирующего учреждения.
Какая аутентификация у API выпуска карт?
Bearer-аутентификация. Каждый запрос, кроме публичной проверки живости, несёт заголовок Authorization: Bearer ck_{keyId}_{secret}. Ключ идентифицирует ваш аккаунт, поэтому ID мерчанта или аккаунта в теле не передаются. Храните ключ только на бэкенде.
Как пополняются карты?
С вашего USDT-кошелька внутри 2328. Пополнение конвертирует стейблкоин в долларовый баланс карты. Кошелёк — USDT с масштабом 6, карты — USD с масштабом 2: суммы всегда целые числа в минимальных единицах с явной валютой и масштабом.
Синхронные ли операции с картами?
Денежные операции асинхронны. Запрос на пополнение или выгрузку возвращает ордер, который вы отслеживаете до завершения, а вебхук подтверждает финальное состояние. Операции чтения — балансы и транзакции — синхронны.
Есть ли песочница?
Есть единая боевая среда — отдельных ключей песочницы нет. Публичный эндпоинт GET /ping доступен без аутентификации для проверок живости.
Для чего можно использовать карты?
Типовые программы: онлайн-подписки, расходы на рекламу, траты сотрудников и подрядчиков, выплаты маркетплейсов и обычные потребительские траты с пополнением в криптовалюте. Разрешённые сценарии согласуются при онбординге программы.