Ошибка «link expired» или пустой экран при попытке сгенерировать Pix Link обычно означает, что ссылка создаётся без обязательных параметров — суммы, идентификатора получателя или срока действия. Прежде чем разбираться в настройке, убедитесь, что у вас активирован хотя бы один ключ Pix (CPF/CNPJ, e-mail, телефон или случайный ключ) в приложении вашего банка: без привязанного ключа создать платёжную ссылку невозможно.
Pix Link — это URL или QR-код, по которому плательщик открывает предзаполненный платёж в системе мгновенных платежей Pix (Центральный банк Бразилии). Такой формат используют продавцы, фрилансеры и обычные пользователи, чтобы не диктовать реквизиты вручную. Ниже разберём, как работает механизм, какие способы генерации существуют и где чаще всего возникают сбои.
Как устроен Pix Link и чем он отличается от ключа Pix
Ключ Pix — это постоянный идентификатор получателя, а ссылка — одноразовый или многоразовый «контейнер» с деталями конкретного платежа. В ссылку можно зашить сумму, описание назначения и срок действия, чего обычный ключ не позволяет. Технически большинство таких ссылок основано на стандарте Pix Cobrança или динамическом QR-коде (BR Code), который банковское приложение плательщика распознаёт автоматически.
Важно понимать: точный набор функций зависит от вашего банка или платёжного провайдера. Один банк позволяет создать ссылку с фиксированной суммой и датой истечения, другой — только статический QR без суммы. Проверьте возможности конкретного приложения, прежде чем планировать сценарий приёма платежей.
Подготовка: что проверить перед созданием ссылки
До генерации ссылки пройдитесь по базовым пунктам — это сэкономит время и убережёт от типовых ошибок вроде «невозможно создать cobrança».
- 🔑 Убедитесь, что в разделе
Pix → Meus limites / Minhas chavesвашего банковского приложения зарегистрирован и подтверждён хотя бы один ключ. - 📱 Обновите приложение банка до актуальной версии — устаревшие сборки могут не поддерживать функцию ссылок или динамических QR-кодов.
- 🌐 Проверьте стабильность интернет-соединения: генерация ссылки требует обращения к серверам банка.
- 🧾 Для бизнес-аккаунтов уточните, включён ли профиль Pix Cobrança — иногда его нужно активировать отдельно через менеджера или интернет-банк.
Если ключ только что создан, учтите, что подтверждение регистрации может занять некоторое время — до завершения верификации ссылка либо не создастся, либо платежи по ней будут отклоняться.
Пошаговая настройка ссылки в банковском приложении
Точные названия пунктов меню различаются у разных банков, поэтому ниже — общий безопасный алгоритм, который нужно сверить с интерфейсом вашего приложения. Ориентируйтесь на разделы с названиями вроде Pix, Cobrar или Receber.
☑️ Создание Pix Link — чек-лист
После генерации приложение покажет готовый URL и/или QR-код. Ссылку можно скопировать и отправить в мессенджер, письмо или вставить на сайт. Плательщик, открыв её на смартфоне, увидит предзаполненный платёж: ему останется только подтвердить перевод.
Обязательно сделайте тестовый платёж на небольшую сумму перед массовой рассылкой ссылки. Так вы проверите, что сумма, описание и получатель отображаются корректно, а деньги реально поступают на нужный счёт.
Статический QR, динамический QR и ссылка: что выбрать
Три формата приёма платежей решают разные задачи, и выбор влияет на удобство обеих сторон.
| Формат | Сумма | Срок действия | Типичный сценарий |
|---|---|---|---|
| Статический QR | Не задана или фиксированная | Бессрочно | Печать на витрине, чаевые |
| Динамический QR | Фиксированная | Ограничен | Счёт за конкретный заказ |
| Pix Link (URL) | Фиксированная или свободная | Задаётся при создании | Отправка в мессенджере, e-mail |
| Ключ Pix | Вводит плательщик | Постоянный | Переводы между знакомыми |
Для разовых счетов с конкретной суммой удобнее динамический QR или ссылка, для постоянного приёма платежей без фиксации суммы — статический код. Ссылка выигрывает, когда плательщик не может отсканировать QR, например при оплате с того же телефона, где открыт чат.
Ссылки через платёжные платформы и API
Бизнесу с регулярными счетами ручная генерация в приложении быстро становится неудобной. В этом случае используют платёжные платформы (эквайеров, PSP), которые создают Pix-ссылки через личный кабинет или API. Подключение обычно требует регистрации юридического лица или ИП и прохождения верификации у провайдера.
Для интеграции через API потребуется разработчик: платформа выдаёт учётные данные (client credentials), а ссылка создаётся запросом вида создания «cobrança» с указанием суммы и срока. Конкретные endpoints и параметры у каждого провайдера свои — ориентируйтесь исключительно на официальную документацию выбранной платформы.
Что такое PSP и зачем он нужен
PSP (Payment Service Provider) — платёжный провайдер, который берёт на себя техническую сторону приёма Pix: генерацию ссылок и QR-кодов, уведомления об оплате (webhook), сверку платежей и возвраты. Взамен провайдер удерживает комиссию с транзакций.
Типичные проблемы и их решения
Чаще всего пользователи сталкиваются с четырьмя сценариями сбоев. Разберём каждый.
- ⏰ Ссылка не открывается или «истекла» — проверьте заданный срок действия и создайте новую ссылку; для долгоживущих сценариев используйте статический QR.
- 💰 Плательщик видит неверную сумму — вероятно, при генерации была указана другая величина; пересоздайте ссылку и не редактируйте старую вручную.
- 🚫 Платёж отклоняется банком плательщика — возможные причины: лимит Pix у плательщика, неподтверждённый ключ получателя, подозрение банка на мошенничество. Попросите плательщика проверить лимиты в его приложении.
- 🔗 Ссылка не открывает банковское приложение — на устройстве плательщика может не быть установлено приложение банка; в этом случае отправьте QR-код или ключ Pix как запасной вариант.
⚠️ Внимание: никогда не генерируйте Pix-ссылки по просьбе третьих лиц, которые обещают «перевести больше и получить разницу обратно». Это классическая схема мошенничества — деньги по такой ссылке уходят с вашего счёта, а входящий платёж оказывается отменённым или украденным.
Безопасность при работе с Pix-ссылками
Платежи Pix зачисляются практически мгновенно и, как правило, необратимы без согласия получателя, поэтому проверка реквизитов — обязанность обеих сторон. Плательщику стоит сверять имя получателя, которое приложение показывает перед подтверждением: оно должно совпадать с ожидаемым продавцом или человеком.
Получателю, в свою очередь, не следует публиковать ссылки с фиксированной суммой в открытом доступе, если платёж предназначен конкретному клиенту, — посторонний может оплатить чужой счёт и создать спорную ситуацию. Для публичных сценариев безопаснее ссылки со свободной суммой или статический QR.
⚠️ Внимание: перед подтверждением оплаты всегда проверяйте полное имя и частично скрытый CPF/CNPJ получателя на экране подтверждения. Pix не проверяет совпадение суммы или описания с реальной сделкой — ответственность за перевод несёт плательщик.
FAQ: частые вопросы о настройке Pix Link
Можно ли создать Pix Link без регистрации ключа Pix?
Нет. Ссылка всегда привязана к счёту получателя через зарегистрированный ключ Pix или реквизиты счёта. Сначала зарегистрируйте ключ в приложении банка, дождитесь его подтверждения и только после этого создавайте ссылку.
Можно ли изменить сумму в уже созданной ссылке?
Как правило, нет: параметры платежа фиксируются при генерации. Если сумма изменилась, создайте новую ссылку, а старую не используйте. Некоторые платформы позволяют отменять активные cobranças — проверьте эту опцию в своём приложении.
Почему плательщик видит другое имя получателя?
Приложение показывает официальные данные владельца счёта из системы Pix, а не текст описания. Если имя не совпадает с ожидаемым, это повод остановиться и уточнить у получателя, тот ли это счёт, прежде чем подтверждать перевод.
Работает ли Pix Link за пределами Бразилии?
Pix — внутрибразильская система, и для оплаты по ссылке плательщику нужен счёт в бразильском банке или платёжном учреждении, подключённом к Pix. Для международных переводов потребуются другие инструменты.
Что делать, если деньги по ссылке не пришли, хотя плательщик подтвердил платёж?
Сначала проверьте выписку и раздел Pix в вашем приложении — иногда зачисление отображается с задержкой интерфейса. Если платёж отсутствует, попросите у плательщика идентификатор транзакции (E2E ID) и обратитесь с ним в поддержку вашего банка для трассировки перевода.