Щоб використовувати PagBank як платіжного провайдера в Mavibot, потрібно отримати токен доступу з вашого облікового запису PagBank і ввести його в налаштуваннях платежів.

Отримання токена

Продуктивне середовище: увійдіть у свій обліковий запис PagBank з комп'ютера, перейдіть до Vendas → Integrações (Продажі → Інтеграції) та натисніть Gerar token (Згенерувати токен).

Тестове середовище (пісочниця): увійдіть на портал розробників PagBank, відкрийте вкладку Tokens і скопіюйте свій токен пісочниці.

Токен відображається лише один раз. Зберігайте його в безпечному місці: якщо ви його втратите, вам потрібно буде згенерувати новий, а старий токен перестане працювати.

Вам не потрібно налаштовувати URL-адресу сповіщення про платіж у своєму обліковому записі PagBank — Mavibot надає її автоматично під час створення кожного платежу.

Налаштування

У налаштуваннях платіжної системи виберіть PagBank і введіть:

  • Token — токен доступу до API з вашого облікового запису PagBank.
  • Test mode — увімкніть цей параметр, якщо ви ввели токен пісочниці. У тестовому режимі запити надсилаються до 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