Глоссарий карточного цифрового банка: БИН, держатель, вебхук и другие термины
Короткий словарь терминов, которые встречаются при запуске виртуальных карт, в панели и в API bin2bin.

Когда команда первый раз запускает карточный слой, спотыкается не о код, а о слова. Ниже — рабочие определения в том смысле, в каком они используются в bin2bin: на сайте, в панели и в документации API. Это не юридический словарь и не энциклопедия платёжной индустрии.

Б
Бесконтактная оплата — способ оплаты картой через телефон в физической точке. В тарифе bin2bin такие карты работают и в магазинах, и в интернете. Три БИНа из четырёх относятся к этому типу: 525847, 441357 и 442601.
БИН (BIN) — Bank Identification Number, первые шесть цифр номера карты. По ним определяется программа выпуска. В тариф входят четыре БИНа; актуальный список отдаёт GET /api/v1/bins.
Боевой режим — рабочий контур после запуска. Боевые ключи имеют префикс b2b_sk_live_ и самостоятельно в песочнице не выпускаются.
В
Вебхук — HTTP-запрос, который bin2bin отправляет на ваш HTTPS-адрес, когда происходит событие: создан или оплачен счёт, и другие случаи, описанные в документации. Нужен ответ 2xx за 5 секунд. Подпись — заголовок X-B2B-Signature.
Виртуальная карта — карта без пластикового носителя. Клиент выпускает её в мини-приложении и пользуется сразу. В API карта создаётся методом POST /api/v1/cards.
Д
Держатель (holder) — человек или учётная запись, к которой выпускается карта. В песочнице держателя создаёт POST /api/v1/holders. Поле external_ref помогает связать его с вашим пользователем; повтор того же значения даёт 409 duplicate.
З
Заморозка карты — временная блокировка операций. В API: POST /api/v1/cards/{id}/freeze и /unfreeze. Пополнение замороженной карты в песочнице возвращает 409 card_frozen.
К
Ключ API — секрет для запросов в заголовке Authorization: Bearer …. Тестовые ключи имеют префикс b2b_sk_test_. Хранится только SHA-256 хэш, поэтому потерянный ключ нельзя восстановить — только выпустить новый и отозвать старый.
М
Мини-приложение — клиентский интерфейс в Telegram под вашим брендом: выпуск карт, пополнения, просмотр операций. Демо: bin2bin.cards/demo.
О
Онлайн-БИН (только онлайн) — программа выпуска, которая работает в интернете и для подписок, но не для оплаты телефоном на кассе. В тарифе это БИН 493724.
Операция (transaction) — пополнение или покупка по карте. В песочнице покупку можно имитировать методом simulate-purchase: операция создаётся всегда, со статусом approved или declined.
П
Пакет карт — 500 карт, которые входят в подключение. Дальнейший выпуск идёт по индивидуальному тарифу, который обсуждается с менеджером.
Песочница (sandbox) — тестовый контур. Открытой регистрации нет: менеджер выдаёт ключ доступа b2b_access_… на почту. Лимит — 60 запросов в минуту на ключ, до 10 активных ключей, отдельные лимиты на держателей и карты.
Пополнение (topup) — перевод средств с баланса на карту. В песочнице: POST /api/v1/cards/{id}/topups. Если на тестовом балансе USD не хватает средств, приходит 409 insufficient_balance.
Под ключ — единственный тариф на сайте. Стоимость подключения — $7 500, оплата полная, одним платежом. В тариф входят 4 БИНа, пакет 500 карт, мини-приложение, панель, API и настройка командой bin2bin.
С
Счёт (invoice) — объект на пополнение тестового баланса. Создаётся в статусе pending и в песочнице через 5 секунд становится paid. На вебхук уходят события invoice.created и invoice.paid. У счёта есть pay_url — тестовая страница, которая ничего не списывает.
Э
Эмиссия — выпуск карт в рамках платёжной программы. В разговоре с bin2bin это практический смысл: ваши клиенты получают виртуальные карты на выбранных БИНах внутри вашего брендированного сервиса. Юридическую модель конкретного проекта обсуждают с менеджером и фиксируют в договоре.
Если термин встретился в панели или в ответе API и его нет в этом списке, напишите @bin2bin_cards — лучше уточнить, чем додумать.


