Чтобы использовать PagBank в качестве платежного провайдера в Mavibot, необходимо получить токен доступа из своей учетной записи PagBank и ввести его в настройках платежей.

Получение токена

Рабочая среда (production): войдите в свою учетную запись PagBank с компьютера, перейдите в раздел Vendas → Integrações (Продажи → Интеграции) и нажмите Gerar token (Сгенерировать токен).

Тестовая среда (sandbox): войдите в Портал разработчика PagBank, откройте вкладку Tokens и скопируйте свой sandbox-токен.

Токен отображается только один раз. Храните его в надежном месте: если вы его потеряете, потребуется сгенерировать новый, а старый токен перестанет работать.

Вам не нужно настраивать URL-адрес уведомления о платеже в своей учетной записи PagBank — Mavibot предоставляет его автоматически при создании каждого платежа.

Настройка

В настройках платежной системы выберите PagBank и укажите:

  • Token — токен доступа к API из вашей учетной записи PagBank.
  • Тестовый режим — включите, если вы ввели sandbox-токен. В тестовом режиме запросы отправляются на sandbox.api.pagseguro.com, и реальные деньги не списываются.

Настройка завершена.

Создание ссылки на оплату

Функция калькулятора:

get_pagbank_payment_url(amount, description, product_name, customer_email, customer_phone, full_name, identity_number)

Параметры

Параметр Описание
amount Сумма платежа. Обязательно. Минимум: 1 BRL; максимум: 9 999 999 BRL. Вводите сумму как 100.55, а не 10055.
description Описание платежа. Необязательно, до 255 символов. Клиент увидит его на странице оплаты.
product_name Название товара, до 100 символов. Необязательно; по умолчанию используется description.
customer_email Адрес электронной почты клиента. Необязательно; предварительно заполняется на странице оплаты.
customer_phone Номер телефона клиента. Необязательно; предварительно заполняется на странице оплаты. PagBank принимает только бразильские мобильные номера: код страны 55, двузначный код города и девятизначный номер, начинающийся с 9 (например, +55 11 99999-8888).
full_name Имя и фамилия клиента. Необязательно; предварительно заполняется на странице оплаты.
identity_number CPF клиента (11 цифр) или CNPJ (14 цифр). Необязательно; предварительно заполняется на странице оплаты.

Функция возвращает URL-адрес платежа.

PagBank принимает данные клиента только в полном комплекте: имя, адрес электронной почты, номер телефона и CPF/CNPJ должны быть предоставлены все. Если хотя бы одно из этих четырех полей отсутствует или номер телефона не является действительным бразильским мобильным номером, Mavibot не отправит никакие данные клиента в PagBank. Клиент просто заполнит их на странице оплаты. Это не влияет на сам платеж.

Ссылка на оплату в кнопке

Чтобы отправить кнопку со ссылкой на оплату, выберите тип кнопки оплаты и укажите PagBank в качестве платежной системы. Введите название товара и сумму платежа. При необходимости укажите переменные, содержащие имя, адрес электронной почты и номер телефона клиента.

Обратные вызовы после оплаты

После того как клиент перейдет по ссылке и завершит оплату, в диалог будет отправлен обратный вызов об успешном платеже:

A1B2C3D4E5_success 100.55

Здесь A1B2C3D4E5 — первые 10 символов вашего токена, а 100.55 — сумма платежа.

Если платеж не удался, будет отправлен следующий обратный вызов:

A1B2C3D4E5_fail 100.55

Обратный вызов об ошибке отправляется только тогда, когда ссылка на оплату больше не может быть использована: банк окончательно отклонил или отменил платеж, или срок действия ссылки истек. Обратный вызов не отправляется, пока платеж находится на рассмотрении, ожидает оплаты через boleto или авторизован, но все еще находится в ожидании на карте, поскольку ссылка на оплату остается активной. Просроченная ссылка на оплату не имеет связанного платежа, поэтому обратный вызов не будет включать сумму.

Чтобы обработать успешный или неудачный платеж, выполните следующие действия:

  1. Создайте блок с триггером (серый блок Trigger или зеленый блок Start — используйте зеленый блок, если хотите продолжить построение воронки после оплаты).
  2. В поле Trigger введите обратный вызов без суммы платежа:
A1B2C3D4E5_success

Используйте этот вариант, если хотите, чтобы блок реагировал на каждый успешный платеж.

Установите тип сопоставления Keyword Match.

Или введите полный обратный вызов:

A1B2C3D4E5_success 100.55

Используйте этот вариант, если хотите, чтобы блок реагировал только на платеж на определенную сумму.

Установите тип сопоставления Exact Match.

Переменные клиента после успешного платежа

Переменная Значение
pagbank_callback_data Информация о платеже, полученная от платежной системы
pagbank_payment_completed "True" — платеж успешно обработан
pagbank_order_id Идентификатор заказа PagBank (ORDE_…)
pagbank_charge_id Идентификатор платежа PagBank (CHAR_…)
pagbank_payment_method Способ оплаты: CREDIT_CARD, DEBIT_CARD, PIX или BOLETO