Оплата через СБП: пошаговая инструкция

СБП — самый быстрый из четырёх способов пополнения на zukko.pro: не нужно вводить номер карты, платёж уходит прямо из банковского приложения. Ниже — весь путь по шагам и разбор мест, где он обычно зависает.

Что нужно заранее

Российский банковский счёт, привязанный к СБП (у большинства крупных банков это включено по умолчанию), и установленное приложение этого банка на телефоне, где будете подтверждать платёж. Ноутбук и телефон не обязаны быть одним устройством — платёж можно инициировать в браузере на компьютере, а подтвердить в приложении банка на телефоне.

Шаги

1. Зайдите в личный кабинет и откройте /app/payments.
2. Выберите способ оплаты "СБП".
3. Укажите сумму пополнения в долларах (минимум $1) — списание по СБП идёт в рублях по рыночному курсу на момент оплаты.
4. Система сгенерирует ссылку или QR-код СБП. На компьютере — отсканируйте QR-код камерой любого банковского приложения (не обязательно того же банка, где счёт, СБП работает между банками). На телефоне — ссылка откроет список банков, выберите свой.
5. В приложении банка откроется экран подтверждения перевода с суммой и получателем. Проверьте сумму до нажатия "Подтвердить" — если сумма не совпадает с введённой в кабинете, платёж лучше отменить и начать заново, а не подтверждать вслепую.
6. После подтверждения в банке возврат в кабинет обычно происходит автоматически; если этого не произошло — вкладку с кабинетом можно просто обновить.

Где СБП обычно зависает

Ссылка открылась, а банк не предложен в списке. Не все банки поддерживают приём через СБП по этой ссылке одинаково — если вашего банка нет в списке при переходе с телефона, используйте вариант с QR-кодом и отсканируйте его через раздел "Оплата по QR" в приложении банка напрямую, минуя автоматический список.

Сессия истекла. У ссылки и QR-кода на оплату есть ограниченное время жизни. Если вы отвлеклись между открытием ссылки в кабинете и подтверждением в банке дольше, чем на несколько минут, безопаснее вернуться в /app/payments и сгенерировать платёж заново, чем пытаться подтвердить старую сессию.

Приложение банка не открывается по ссылке на компьютере. Это ожидаемо — диплинк на приложение банка работает только на том устройстве, где это приложение установлено. На компьютере используйте QR-код, а не саму ссылку.

Оплата ушла, а баланс в кабинете не поменялся. Кабинет может отставать на несколько секунд от фактического зачисления. Проверьте баланс напрямую через API, не полагаясь на визуальное состояние страницы:

curl https://api.zukko.pro/v1/balance \
  -H "Authorization: Bearer fetch_ваш_ключ"

Если баланс не поменялся спустя пару минут после успешного списания в банковском приложении, не отправляйте платёж повторно — обратитесь в поддержку https://t.me/zukkopro?direct↗ с суммой, временем операции и, если есть, номером СБП-перевода из истории банка.

Проверка через заголовки ответа, а не только через дашборд

Если вы уже пользуетесь API и хотите видеть остаток без отдельного похода на /app/payments, обратите внимание, что обычный (не потоковый) ответ от API содержит заголовок X-Fetch-Balance-Cents с остатком баланса после списания за конкретный запрос — так можно следить за балансом попутно, без лишних вызовов GET /v1/balance. Несмотря на название, значение в нём в микродолларах (1 000 000 = $1), а не в центах; у ответов с stream: true заголовка нет. Точный баланс в центах отдаёт GET /v1/balance (поле balance_cents).

Автоматизация повторных пополнений

Если вы хотите, чтобы скрипт следил за остатком, пусть он присылает вам уведомление при падении баланса ниже порога, а сам платёж по СБП вы подтверждаете в приложении банка. Idempotency-Key на пополнения не распространяется — он работает только для запросов к моделям (POST /v1/chat/completions, /v1/messages, /v1/responses). Поэтому защита от двойной оплаты здесь та же, что и при ручном платеже: если зачисление задерживается, не отправляйте платёж повторно, а проверьте баланс через GET /v1/balance и при необходимости напишите в поддержку. Пополнения, кстати, не попадают и в GET /v1/usage — там только расход на запросы к моделям.

Что не работает через СБП

СБП принимает переводы только со счетов в российских банках. Если у вас нет российского счёта — например, вы платите из Казахстана или другой страны СНГ без счёта в РФ — этот способ не подойдёт вообще, независимо от того, какой картой вы обычно пользуетесь: нужны либо иностранная карта Mastercard EU через Fride, либо крипта.

Быстрая проверка после оплаты

Если сомневаетесь, прошёл ли платёж, самый надёжный способ — не смотреть на интерфейс кабинета, а спросить баланс напрямую у API тем же ключом, которым пользуетесь для запросов к моделям. Если баланс вырос на сумму пополнения — деньги дошли, можно продолжать работу.

Почему стоит пополнять чуть больше, чем нужно на день

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

Что делать, если банк требует звонок для подтверждения

Изредка банк не присылает push для подтверждения СБП-перевода, а вместо этого блокирует операцию до звонка в поддержку — это решение самого банка, а не zukko.pro, и связано с внутренними антифрод-правилами конкретного банка на конкретную сумму или получателя. В этом случае быстрее позвонить в банк по номеру с обратной стороны карты, чем пытаться повторить платёж ещё раз с той же суммой — повтор с высокой вероятностью попадёт под ту же блокировку.