Оплата иностранной картой Mastercard EU

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

Зачем нужен отдельный процессинг для иностранных карт

PayPear принимает карты, привязанные к российским банкам, и работает через НСПК. Карта, выпущенная банком в Евросоюзе, физически не пройдёт через этот маршрут — она в НСПК не заведена. Поэтому для карт такого типа подключён отдельный шлюз, Fride, который обрабатывает международный Mastercard напрямую, минуя НСПК.

Из-за этого в кабинете на странице /app/payments вы увидите не один пункт "карта", а два отдельных способа: обычная карта (PayPear, для российских банков) и "иностранная карта Mastercard EU" (Fride). Перепутать их легко, потому что интерфейс отличается только подписью кнопки, а не расположением.

Как пополнить баланс

1. Откройте /app/payments в личном кабинете.
2. Выберите способ "Иностранная карта Mastercard EU".
3. Укажите сумму пополнения в долларах — для этого способа от $2 до $594. Учтите, что у этого способа комиссия около 13%. Конвертация в евро при списании с карты происходит по курсу Fride на момент операции.
4. Введите данные карты (номер, срок действия, CVC) на форме Fride — это отдельная страница процессинга, а не форма zukko.pro, и вводить данные карты нужно только там.
5. Подтвердите платёж через 3-D Secure — обычно это push-уведомление в приложении банка или одноразовый код по SMS.
6. После подтверждения баланс обновляется в кабинете и становится виден через GET /v1/balance.

Частые причины отказа

Банк блокирует первую операцию у нового получателя. Многие европейские банки по умолчанию настороженно относятся к первому платежу в адрес незнакомого мерчанта и молча его отклоняют. Первое, что стоит сделать после отказа — открыть приложение банка: там часто лежит push с просьбой вручную подтвердить или отклонить операцию.

Карта ограничена только внутренними платежами. У части дебетовых карт по умолчанию включено ограничение на трансграничные онлайн-платежи. В этом случае Fride получает отказ ещё до экрана 3-D Secure. Снимается ограничение в приложении банка или звонком в поддержку банка.

Разница в курсе конвертации. Списание идёт в евро по курсу Fride на момент операции, который может на 1–3% отличаться от курса ЦБ или курса, который показывает Google. Это не двойное списание и не ошибка — так работает любая конвертация в валюту, отличную от валюты счёта карты. Отдельно от курса у этого способа есть комиссия около 13% — учитывайте её, когда сравниваете сумму в выписке с суммой пополнения.

Сумма вне диапазона. Через Mastercard EU можно пополнить на сумму от $2 до $594 за один платёж — меньшую или большую сумму этим способом пополнить не получится.

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

Если деньги списались, а баланс не обновился

Сначала проверьте баланс напрямую через API, не полагаясь на кеш страницы в браузере:

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

Ответ содержит текущий баланс аккаунта. Если баланс не изменился, а списание с карты уже видно в банковском приложении, не создавайте повторный платёж — иногда подтверждение от банка доходит до Fride с задержкой в несколько минут из-за самого протокола 3-D Secure. Если после 15–20 минут баланс всё ещё не обновился, напишите в поддержку https://t.me/zukkopro?direct↗ с указанием времени операции и последних четырёх цифр карты.

Идемпотентность и автоматические пополнения

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

Безопасность данных карты

Форма ввода номера карты, срока действия и CVC принадлежит Fride, а не zukko.pro — гейтвей никогда не видит и не хранит эти данные, к нему приходит только результат авторизации платежа. Если где-то за пределами страницы /app/payments у вас просят ввести номер карты для "пополнения баланса zukko.pro" — это не имеет отношения к сервису.

Если Mastercard EU не подходит

Если карта раз за разом отклоняется, а СБП недоступен из-за того, что счёт не в российском банке, остаётся крипта — она не зависит ни от НСПК, ни от банковского процессинга и работает независимо от страны выпуска карты или банка. Вариант с криптой находится на той же странице /app/payments, рядом с остальными способами оплаты.

Как убедиться, что пополнение точно нужно именно через Fride

Если вы не уверены, какой из двух пунктов на странице /app/payments относится к вашей карте, проще всего смотреть не на страну проживания, а на то, каким банком выпущена карта физически. Российский банк — PayPear, независимо от того, где вы сейчас находитесь. Банк из ЕС — Fride, даже если вы сами гражданин другой страны. Путаница обычно возникает у тех, кто переехал и держит карты обоих банков одновременно: в этом случае стоит один раз проверить мелким пополнением, какой способ сработает именно с нужной картой, вместо того чтобы каждый раз гадать заново.

Что видно в истории после успешного платежа

После того как баланс обновился, новый остаток виден в кабинете и через GET /v1/balance. В GET /v1/usage пополнения не попадают — там только расход на вызовы моделей (поля created_at, model, токены, cost_cents). Если пополнений несколько за месяц и нужно свести их с расходом в одну таблицу, пополнения берите из кабинета и банковской выписки, а расход — из /v1/usage.