Раздел 2Checkout Integration в конструкторе Gridbox описывает процесс подключения и конфигурирования глобального платежного шлюза 2Checkout (Verifone) в интернет-магазине (Store App). Интеграция со шлюзом 2Checkout позволяет принимать трансграничные платежи по банковским картам и через кошельки PayPal по всему миру с автоматической сменой статуса заказа на сайте.
1. Получение учетных данных API 2Checkout (Getting 2Checkout API Credentials)
Для подключения магазина к платежной системе 2Checkout вам понадобятся: Merchant Code (Код мерчанта), Publishable Key (Публичный ключ), Private Key (Приватный ключ) и Secret Word (Секретное слово):
- Войдите в личный кабинет продавца 2Checkout Merchant Control Panel (для боевого режима) или в панель тестовой среды 2Checkout Sandbox Panel (официальный сайт платформы — 2Checkout.com / Verifone).
- В верхнем главном меню панели управления перейдите в раздел Integrations ➝ Webhooks & API.
- В блоке API скопируйте ваш Merchant Code (Код продавца / Account Number).
- В том же блоке найдите и скопируйте значения Publishable Key и Private Key (если ключи не сгенерированы, нажмите кнопку Generate Key).
- В блоке Secret Word скопируйте секретное слово (или введите новое надежное кодовое слово и сохраните форму, нажав Update).
2. Настройка URL перенаправления и Webhooks (Redirect URL & Webhooks)
Чтобы покупатель после успешной оплаты автоматически возвращался в магазин, а сайт получал мгновенные уведомления о статусе транзакции:
- В панели 2Checkout перейдите в раздел Integrations ➝ Webhooks & API.
- Найдите подраздел Redirect URL:
- В поле Approved URL укажите URL-адрес страницы успешного оформления заказа вашего сайта (Thank You Page) или системный адрес возврата Gridbox.
- В выпадающем списке Return method выберите тип Header redirect.
- В блоке Notifications (INS / Instant Notification System) включите опцию Enable INS и вставьте URL обработчика уведомлений Gridbox для автоматической фиксации платежей.
- Нажмите кнопку Save внизу страницы панели 2Checkout.
3. Настройка платежного метода в Gridbox (Configuring 2Checkout in Gridbox)
После получения учетных данных завершите настройку в панели управления Joomla:
- В панели управления Gridbox перейдите по пути: Store App ➝ Settings ➝ Payment Methods.
- Нажмите кнопку Add New Item и выберите в списке доступных шлюзов 2Checkout.
- В поле Title укажите публичный заголовок для покупателей (например, Оплата онлайн (2Checkout / Банковские карты)).
- Вставьте скопированный Merchant Code в соответствующее поле настроек.
- Вставьте скопированный Publishable Key в поле публичного ключа.
- Вставьте скопированный Private Key в поле приватного ключа.
- Вставьте скопированный Secret Word в поле секретного слова.
- В выпадающем списке Environment выберите режим: Sandbox (для тестирования) или Production (для реальных продаж).
- Активируйте переключатель Published и нажмите Save.
4. Сводная таблица параметров 2Checkout Integration
Полный перечень параметров конфигурации платежного шлюза 2Checkout в Gridbox:
| Параметр / Поле | Описание и функциональное назначение | Формат / Источник |
|---|---|---|
| Title | Название способа оплаты, отображаемое клиентам на странице оформления заказа. | Текстовая строка |
| Merchant Code | Уникальный номер учетной записи (Account Number / Seller ID) мерчанта в 2Checkout. | Числовой / Буквенный код |
| Publishable Key | Публичный API-ключ для инициализации платежной формы 2Checkout JavaScript SDK. | Публичный токен |
| Private Key | Секретный закрытый ключ API для авторизации транзакций на стороне сервера. | Приватный токен |
| Secret Word | Секретное кодовое слово для проверки валидности цифровой подписи входящих ответов от 2Checkout. | Секретная строка |
| Environment | Выбор режима работы: Sandbox (тестирование) или Production (прием реальных денег). | Выпадающий список (Sandbox / Production) |
| Published | Статус публикации и доступности платежного шлюза для покупателей. | Переключатель (Yes/No) |
| Save | Сохранение параметров интеграции в базе данных Joomla. | Кнопка действия |
2Checkout берет на себя все вопросы налогообложения, соответствия местным законам (Merchant of Record) и защиты от мошенничества благодаря встроенной системе фрод-мониторинга. Данные карт обрабатываются по стандарту PCI-DSS Level 1.
Убедись, что значение поля Secret Word в панели Gridbox символьно совпадает со значением Secret Word в панели управления 2Checkout. Если хотя бы один символ или регистр букв будет отличаться, хэш-подпись транзакции (MD5/SHA-256 hash) не сойдется, и статус заказа в магазине останется в статусе «Не оплачен», даже если деньги с карты клиента успешно списались.