B2B API IMBA Wallet: карты, eSIM и gift cards для своего продукта
IMBA Wallet даёт компаниям программный доступ к выпуску и пополнению виртуальных карт и — при подключении в договоре — к покупке travel eSIM и цифровых подарочных карт. Вы продаёте клиенту на своём сайте или в своём сервисе, принимаете оплату сами, а исполнение заказа уходит в IMBA по API. Покупатель остаётся у вас — ему не нужно открывать приложение IMBA Wallet.
Краткие факты о B2B API
| Для кого | Сайты, боты, маркетплейсы и финтех-сервисы, которым нужен выпуск цифровых продуктов через свой интерфейс |
|---|---|
| Продукты | Виртуальные карты по согласованному продукту; eSIM и gift cards — только если каталог включён в договоре |
| Расчёты | Единый баланс компании в USDT; пополнение депозитом TRC-20 |
| Клиенты компании | Не логинятся в IMBA Wallet; заказ идёт от сервера компании |
| Статусы | Webhook + запрос статуса по API |
| Доступ | После договора: ключи авторизации, scopes и URL уведомлений |
Что даёт API бизнесу?
Вы встраиваете цифровые продукты IMBA в свой сценарий продаж, не собирая карточный и eSIM-контур с нуля.
Чем B2B API отличается от обычного аккаунта в приложении?
Розничный пользователь IMBA Wallet покупает карту или eSIM для себя. B2B-контур рассчитан на компанию, которая продаёт эти продукты своим клиентам.
| Кто платит IMBA | В рознице — пользователь; в B2B — компания со своего USDT-баланса |
|---|---|
| Где покупает человек | В рознице — в приложении IMBA; в B2B — на сайте или в сервисе компании |
| Как вызываются операции | В рознице — UI приложения; в B2B — серверные вызовы API с токеном компании |
| Тарифы | В B2B задаются индивидуально при подключении, отдельно от розничного каталога |
Как выглядит типовой сценарий продажи
Клиент оплачивает вам. Эквайринг, крипта или другой способ — на вашей стороне. IMBA факт оплаты клиента не проверяет.
Ваш бэкенд вызывает API. Передаёте продукт, сумму, данные держателя для карты и свой внешний id заказа.
Средства резервируются на балансе компании. Если USDT не хватает, отказ приходит сразу, заказ не стартует.
Исполнение завершается асинхронно. Успех или ошибка приходят webhook’ом; при сбое резерв возвращается на доступный баланс.
Вы выдаёте результат клиенту. Карту, eSIM-профиль или код gift card показываете в своём кабинете по правилам контракта.
Баланс, депозит и вывод USDT
У компании один расчётный баланс в USDT. Пополнение — перевод USDT в сети TRC-20 на закреплённый депозитный адрес. С этого баланса списываются выпуск и пополнение карт, покупка eSIM и gift cards, а также вывод USDT, если он разрешён договором.
В ответе баланса видно доступную сумму и зарезервированную. Пока операция в работе, часть средств удерживается; при отмене или ошибке удержание снимается. Отдельного «личного» кошелька конечного покупателя на стороне IMBA в этом контуре нет.
Какие операции доступны
Набор scopes и каталог продуктов включаются при онбординге. Базовый контур обычно включает карты; eSIM и gift cards подключаются отдельно и по умолчанию могут быть выключены, пока их не включат в договоре:
Дополнительно API отдаёт баланс, адрес депозита и заявки на вывод USDT (при соответствующем праве доступа). Идемпотентность строится на внешнем идентификаторе заказа: повтор того же запроса не создаёт второго списания при том же теле.
Безопасность и уведомления
Доступ — по криптографической авторизации сервера компании (короткоживущий access token и ограниченные scopes). Идентификатор компании берётся из токена, а не из тела запроса. Для асинхронных событий регистрируется webhook URL с проверкой подписи.
Чувствительные данные карты и коды активации в webhook не передаются: их получают отдельным защищённым запросом статуса или деталей заказа по правилам контракта. Внутренние служебные идентификаторы учёта наружу не отдаются.
Кому это подходит
Маркетплейс карт — продаёте виртуальные карты, принимаете оплату сами, выпускаете карту по API после оплаты.
Travel-сервис — в чекаут поездки добавляете eSIM (если каталог подключён) и выдаёте данные активации клиенту в своём приложении.
Бот или витрина gift cards — каталог брендов у вас, исполнение покупки и доставка кода — через IMBA при включённом каталоге.
Финтех / агентский канал — нужен программный выпуск цифровых продуктов без того, чтобы каждый конечный клиент проходил розничный онбординг IMBA.
Как подключиться
Напишите в поддержку IMBA Wallet на support@imbawallet.com или через Telegram-бота / группу @imbawallet_rus и укажите, что нужен B2B API.
Согласуйте договор и продукты — юрлицо, карточные продукты, нужно ли включать eSIM/gift, лимиты и webhook.
Получите ключи доступа, пополните USDT TRC-20 и проведите пробный заказ на согласованных продуктах.
Выведите интеграцию в прод после проверки статусов, идемпотентности и выдачи данных клиенту.
Читайте также
FAQ
Что такое B2B API IMBA Wallet?
Это программный интерфейс для компаний, которые продают виртуальные карты, travel eSIM и подарочные карты своим клиентам через собственный сайт, бот или маркетплейс. Исполнение заказов идёт через IMBA, а покупатель остаётся в интерфейсе компании.
Нужно ли клиентам компании регистрироваться в IMBA Wallet?
Нет. Конечные покупатели не входят в приложение IMBA Wallet и не получают клиентский доступ. Все операции выполняет сервер компании с B2B-токеном.
Чем оплачиваются выпуски по API?
Со счёта компании в USDT. Баланс пополняется депозитом USDT в сети TRC-20 на закреплённый адрес. Если доступных средств недостаточно, заказ не создаётся.
Какие продукты доступны через API?
Виртуальные карты с выпуском и пополнением по согласованному карточному продукту. Travel eSIM и цифровые подарочные карты — только если соответствующие каталоги включены при подключении; по умолчанию они могут быть выключены.
Как узнать, что карта или заказ готовы?
Основной канал — webhook на URL компании. Дополнительно статус можно запросить по API. Полные реквизиты карты и коды активации в webhook не приходят — их получают отдельным защищённым запросом по правилам контракта.