bin2binМенеджер
How-to с кодом· 3 мин чтения

СБП-эквайринг: как клиенты пополняют карты по 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". После этого рубли появляются на балансе, и карту можно пополнить.

Полный разбор ключей, подписи вебхука и выпуска карты — в статье «Как в песочнице создать счёт, пополнить баланс и поймать вебхук». Раздел документации «Пополнение по СБП» описывает те же поля.

bash
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 Mastercard Бесконтактная оплата
441357 Visa Бесконтактная оплата
442601 Visa Бесконтактная оплата
493724 Visa Только онлайн

Карты с бесконтактной оплатой работают и в интернете. После пакета из 500 карт действует индивидуальный тариф, его условия согласуются с менеджером. Договор на сайте не публикуется: его присылает менеджер.

Как проходит запуск целиком — в статье «Как запустить брендированный цифровой банк в Telegram».

Как проверить это в песочнице

Открытой регистрации нет: ключ доступа к песочнице выдаёт менеджер. В песочнице тот же запрос POST /api/v1/invoices с method: "sbp" и currency: "RUB" создаёт тестовый счёт. pay_url открывает тестовую страницу СБП с макетом QR и пометкой, что платёж не настоящий. Через 5 секунд счёт сам становится paid, сумма зачисляется на тестовый баланс RUB, на вебхук уходит invoice.paid. Реальные деньги не списываются.

bash
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 с тем же объектом счёта. Когда цикл в песочнице проходит стабильно, его же можно обсуждать как основу боевой интеграции. Боевые ключи самостоятельно не выпускаются — их выдаёт менеджер.

Кратко

  1. Создаёте счёт с method: "sbp", currency: "RUB" и суммой в копейках.
  2. Отдаёте клиенту pay_url — как QR-код или как ссылку.
  3. Клиент подтверждает платёж в приложении банка.
  4. Приходит вебхук invoice.paid, рубли появляются на балансе, карту можно пополнить.

Чтобы подключить этот сценарий в своём продукте, напишите @bin2bin_cards — первое сообщение от вас — или на connect@bin2bin.cards.

Обсудить свой карточный продукт

Напишите менеджеру в Telegram. Расскажем о тарифе «Проект под ключ + подключение СБП-эквайринга», подберём сценарий под вашу аудиторию и откроем песочницу после одобрения заявки.

Написать @bin2bin_cards

Читайте также