Раздел PagSeguro Integration в конструкторе Gridbox описывает процесс подключения и настройки платежного сервиса PagSeguro (PagBank) в интернет-магазине (Store App). Интеграция с PagSeguro позволяет принимать платежи на рынке Бразилии в национальной валюте (BRL) с поддержкой кредитных и дебетовых карт всех основных платежных систем, квитанций Boleto Bancário, банковских переводов и системы быстрых платежей PIX.
1. Получение учетных данных API PagSeguro (Getting PagSeguro API Credentials)
Для подключения интернет-магазина к шлюзу PagSeguro вам понадобятся: Email (адрес электронной почты учетной записи продавца) и Token (токен безопасности API):
- Войдите в личный кабинет мерчанта на портале Личный кабинет PagSeguro (UOL) (для боевого режима) или в кабинет тестовой среды PagSeguro Sandbox (официальный портал сервиса — PagBank / PagSeguro, техническая документация для разработчиков — PagSeguro Developer Portal).
- В главном меню личного кабинета перейдите в раздел Venda online (Онлайн-продажи) ➝ Integrações (Интеграции).
- В блоке Utilização de APIs (Использование API) найдите пункт Gerar Token (Сгенерировать токен).
- Нажмите кнопку генерации токена — система PagSeguro создаст уникальный защитный ключ и при необходимости отправит код подтверждения на ваш контактный email/телефон.
- Скопируйте сгенерированный Token (строка из 32 символов) и зафиксируйте ваш Email, используемый для авторизации в PagSeguro.
2. Настройка PagSeguro в панели Gridbox Store (Configuring PagSeguro in Gridbox)
После получения учетных данных выполните привязку платежного метода в административной панели сайта:
- В панели управления Gridbox перейдите по пути: Store App ➝ Settings ➝ Payment Methods.
- Нажмите кнопку Add New Item и выберите в списке доступных шлюзов PagSeguro.
- В поле Title укажите отображаемое название метода для покупателей (например, Pagamento online: PagSeguro / Cartão de Crédito / Boleto / PIX).
- В поле Email введите email-адрес вашей учетной записи в PagSeguro.
- Вставьте скопированный Token в поле токена безопасности.
- В выпадающем списке Environment установите рабочий режим: Sandbox (для тестирования) или Production (для приема реальных средств).
- Активируйте переключатель Published для отображения метода оплаты в корзине (Checkout).
- Нажмите кнопку Save для сохранения настроек.
3. Сводная таблица параметров PagSeguro Integration
Полный перечень параметров конфигурации платежного шлюза PagSeguro в Gridbox:
| Параметр / Поле | Описание и функциональное назначение | Формат / Источник |
|---|---|---|
| Title | Публичное название метода оплаты, отображаемое клиентам при оформлении заказа на сайте. | Текстовая строка |
| Email-адрес учетной записи продавца (Conta PagBank / PagSeguro), на которую зачисляются средства. | Email-адрес | |
| Token | Секретный токен безопасности (API Token), сгенерированный в кабинете PagSeguro. | 32-значный хэш-токен |
| Environment | Выбор среды выполнения: Sandbox (тестовая песочница) или Production (боевой прием оплат). | Выпадающий список (Sandbox / Production) |
| Published | Статус публикации и видимости способа оплаты для покупателей в корзине интернет-магазина. | Переключатель (Yes/No) |
| Save | Сохранение параметров интеграции платежного шлюза в базе данных сайта. | Кнопка действия |
PagSeguro является частью медиагиганта UOL и сертифицирован по стандарту PCI-DSS. Платежный шлюз автоматически защищает мерчантов от мошеннических транзакций и чарджбэков, используя встроенную многофакторную систему антифрода.
Обязательно убедись, что в Store Settings ➝ Currency установлена валюта BRL (Бразильский реал, R$), поскольку PagSeguro осуществляет процессинг исключительно в национальной валюте Бразилии. При переключении шлюза из тестового режима Sandbox в боевой Production не забудь сгенерировать и вставить боевой токен из реального кабинета мерчанта.