Раздел Square Integration в конструкторе сайтов Gridbox для Joomla описывает пошаговый процесс подключения и конфигурирования платежного шлюза Square в интернет-магазине (Store App). Интеграция со Square позволяет безопасно принимать оплату кредитными и дебетовыми картами напрямую на сайте, обеспечивая быструю обработку транзакций и автоматическую синхронизацию статусов заказов.
1. Получение учетных данных API Square (Getting Square API Credentials)
Для интеграции магазина с платежным шлюзом Square вам понадобятся три параметра: Application ID, Access Token и Location ID. Чтобы получить их:
- Перейдите на официальный портал для разработчиков Square Developer Dashboard и авторизуйтесь под своей учетной записью (или зарегистрируйте новый бизнес-аккаунт на главном сайте Squareup.com).
- В панели управления приложениями нажмите кнопку + Add Application (или New Application) для создания нового платежного приложения.
- Введите имя приложения (например, Gridbox Store Online) и нажмите кнопку Save / Create Application.
- В верхней части страницы созданного приложения выберите нужное рабочее окружение с помощью переключателя: Sandbox (тестовая среда песочницы для симуляции оплат) или Production (боевой рабочий режим для приема реальных денег).
- В левом боковом меню перейдите во вкладку Credentials:
- Скопируйте значение из поля Application ID.
- В строке Access token нажмите Show и скопируйте сгенерированный токен доступа.
- В левом меню перейдите во вкладку Locations: найдите в списке вашу торговую точку / локацию бизнеса и скопируйте ее уникальный Location ID.
2. Настройка платежного метода Square в Gridbox (Configuring Square in Gridbox)
После получения всех учетных данных перейдите в административную панель вашего сайта:
- В панели управления Gridbox откройте настройки интернет-магазина: Store App ➝ Settings ➝ Payment Methods.
- Нажмите кнопку Add New Item и выберите в списке шлюзов Square.
- В поле Title укажите публичный заголовок для покупателей (например, Оплата банковской картой онлайн (Square)).
- Вставьте скопированный Application ID в соответствующее поле настроек.
- Вставьте скопированный Access Token в поле токена доступа.
- Вставьте скопированный Location ID в поле идентификатора локации.
- В выпадающем списке Environment установите соответствующий режим: Sandbox (для проверки работы) или Production (для приема реальных заказов).
- Активируйте переключатель Published и нажмите кнопку Save для сохранения параметров.
3. Сводная таблица параметров Square Integration
Полный перечень параметров конфигурации платежного шлюза Square в Gridbox:
| Параметр / Поле | Описание и функциональное назначение | Формат / Источник |
|---|---|---|
| Title | Название способа оплаты, отображаемое покупателю на этапе оформления заказа (Checkout). | Текстовая строка |
| Application ID | Идентификатор приложения Square (Sandbox App ID или Production App ID). | sq0idp-... / sandbox-sq0idb-... |
| Access Token | Токен авторизации для безопасного взаимодействия API сайта с серверами Square. | EAAA... (Секретный токен) |
| Location ID | Идентификатор конкретного бизнес-аккаунта / торговой точки, к которой привязываются входящие платежи. | Идентификатор локации |
| Environment | Выбор режима работы: Sandbox (тестирование без списаний) или Production (прием реальных оплат). | Выпадающий список (Sandbox / Production) |
| Published | Переключатель активации и публикации метода оплаты в чекауте магазина. | Переключатель (Yes/No) |
| Save | Сохранение внесенной конфигурации платежного шлюза в базу данных. | Кнопка действия |
Интеграция Square в Gridbox использует безопасный механизм Square Web Payments SDK. Данные банковских карт вводятся в зашифрованные поля, мгновенно токенизируются на стороне Square и не попадают на сервер вашего сайта, что обеспечивает 100% соответствие уровню безопасности PCI-DSS Level 1.
Обрати внимание: ключи от режима Sandbox (начинаются с sandbox-) и боевого режима Production (начинаются с sq0idp-) полностью изолированы друг от друга. При переключении тумблера Environment с Sandbox на Production обязательно замени и Application ID, и Access Token, и Location ID на их боевые версии из вкладки Production в консоли Square Developer.