СБП-эквайринг: как клиенты пополняют карты по QR и по ссылке
Как устроено пополнение виртуальных карт в рублях через СБП — счёт в API, QR-код и ссылка оплаты, вебхук invoice.paid и проверка сценария в песочнице.

Клиенты вашего цифрового банка в Telegram выпускают виртуальные карты и пополняют их в рублях через СБП. Оплата проходит в приложении банка: по QR-коду или по ссылке. Подключение СБП-эквайринга входит в тариф «Проект под ключ + подключение СБП-эквайринга» — отдельно его собирать не нужно.
Ниже — как этот сценарий выглядит для пользователя, что происходит в API и как проверить его в песочнице. Для запуска достаточно понять цепочку «счёт → оплата → вебхук → баланс → карта».
Что видит пользователь
В мини-приложении клиент выбирает сумму пополнения в рублях. Ему показывают страницу оплаты СБП. Есть два способа открыть один и тот же счёт:
- QR-код. Пользователь сканирует код камерой в приложении банка и подтверждает платёж.
- Ссылка оплаты. Пользователь переходит по
pay_urlи подтверждает платёж в приложении банка.
Разница только в том, как открыть счёт. После подтверждения сумма зачисляется на баланс, и карту можно пополнить.
Как это устроено в API
Сценарий начинается с создания счёта. Вы вызываете POST /api/v1/invoices и передаёте:
method:"sbp";currency:"RUB"— для СБП валюта только рубли;amount_cents— сумма в копейках:150000это 1 500.00 ₽;description— назначение платежа, по желанию, до 200 символов.
В ответе приходит объект счёта в статусе pending и поле pay_url. Эту ссылку вы отдаёте клиенту: показываете как QR или как кнопку оплаты. Пользователь открывает её и подтверждает платёж в приложении банка. На ваш сервер уходит вебхук invoice.paid с тем же объектом счёта, включая method: "sbp". После этого рубли появляются на балансе, и карту можно пополнить.
Полный разбор ключей, подписи вебхука и выпуска карты — в статье «Как в песочнице создать счёт, пополнить баланс и поймать вебхук». Раздел документации «Пополнение по СБП» описывает те же поля.
curl -X POST https://bin2bin.cards/api/v1/invoices \
-H "Authorization: Bearer $B2B_KEY" \
-H "Content-Type: application/json" \
-d '{"amount_cents":150000,"currency":"RUB","method":"sbp","description":"Пополнение по СБП"}'В ответе будут id, method и pay_url. Базовый URL API: https://bin2bin.cards/api/v1.
Что входит в тариф
«Проект под ключ + подключение СБП-эквайринга» — единственный тариф на сайте. Стоимость подключения — $7 500, оплата полная, одним платежом. В тариф входят:
- брендированное мини-приложение в Telegram;
- пакет из 500 карт;
- 4 БИНа;
- подключение СБП-эквайринга: клиенты пополняют карты в рублях через СБП;
- админ-панель и API;
- настройка и запуск командой bin2bin.
Четыре БИНа, которые входят в тариф:
| БИН | Платёжная сеть | Тип использования |
|---|---|---|
| 525847 | Бесконтактная оплата | |
| 441357 | Бесконтактная оплата | |
| 442601 | Бесконтактная оплата | |
| 493724 | Только онлайн |
Карты с бесконтактной оплатой работают и в интернете. После пакета из 500 карт действует индивидуальный тариф, его условия согласуются с менеджером. Договор на сайте не публикуется: его присылает менеджер.
Как проходит запуск целиком — в статье «Как запустить брендированный цифровой банк в Telegram».
Как проверить это в песочнице
Открытой регистрации нет: ключ доступа к песочнице выдаёт менеджер. В песочнице тот же запрос POST /api/v1/invoices с method: "sbp" и currency: "RUB" создаёт тестовый счёт. pay_url открывает тестовую страницу СБП с макетом QR и пометкой, что платёж не настоящий. Через 5 секунд счёт сам становится paid, сумма зачисляется на тестовый баланс RUB, на вебхук уходит invoice.paid. Реальные деньги не списываются.
sleep 5
curl https://bin2bin.cards/api/v1/invoices/<id счёта> \
-H "Authorization: Bearer $B2B_KEY"
curl https://bin2bin.cards/api/v1/balance \
-H "Authorization: Bearer $B2B_KEY"Если вебхук настроен, к этому моменту на вашем сервере уже должно лежать событие invoice.paid с тем же объектом счёта. Когда цикл в песочнице проходит стабильно, его же можно обсуждать как основу боевой интеграции. Боевые ключи самостоятельно не выпускаются — их выдаёт менеджер.
Кратко
- Создаёте счёт с
method: "sbp",currency: "RUB"и суммой в копейках. - Отдаёте клиенту
pay_url— как QR-код или как ссылку. - Клиент подтверждает платёж в приложении банка.
- Приходит вебхук
invoice.paid, рубли появляются на балансе, карту можно пополнить.
Чтобы подключить этот сценарий в своём продукте, напишите @bin2bin_cards — первое сообщение от вас — или на connect@bin2bin.cards.


