Раздел LiqPay Integration в конструкторе Gridbox описывает процесс подключения и конфигурирования сервиса интернет-эквайринга LiqPay в интернет-магазине (Store App). Интеграция с LiqPay позволяет покупателям быстро и безопасно оплачивать заказы с помощью банковских карт Visa, MasterCard, через интернет-банк Privat24, кошельки Apple Pay и Google Pay, а также наличными через терминалы самообслуживания.
1. Получение учетных данных API LiqPay (Getting LiqPay API Credentials)
Для подключения магазина к платежному шлюзу LiqPay вам понадобятся два ключа: Public Key (открытый публичный ключ) и Private Key (секретный приватный ключ):
- Войдите в личный бизнес-кабинет мерчанта на портале LiqPay Merchant Dashboard / Бизнес-кабинет (официальный сайт платежного сервиса — LiqPay.ua, техническая документация API — LiqPay API Documentation).
- Авторизуйтесь с помощью номера телефона, подтвердив вход через SMS-код или мобильное приложение.
- В боковом меню кабинета выберите ваш подключенный интернет-магазин в разделе Мои магазины (My Shops) (или добавьте новую компанию, заполнив реквизиты).
- Перейдите в подраздел Настройки ➝ API (Settings ➝ API Keys).
- Скопируйте сгенерированные параметры:
- Public Key: Публичный идентификатор мерчанта (строка вида
i00000000000); - Private Key: Секретный закрытый ключ для подписи данных (нажмите кнопку отображения ключа и сохраните строку).
- Public Key: Публичный идентификатор мерчанта (строка вида
2. Настройка платежного метода LiqPay в Gridbox (Configuring LiqPay in Gridbox)
После получения ключей завершите привязку платежного шлюза в административной панели сайта:
- В панели управления Gridbox перейдите по пути: Store App ➝ Settings ➝ Payment Methods.
- Нажмите кнопку Add New Item и выберите в списке доступных шлюзов LiqPay.
- В поле Title укажите публичный заголовок для покупателей (например, Оплата онлайн: Карты (Visa / MasterCard), Privat24, Apple Pay).
- Вставьте скопированный Public Key в соответствующее поле настроек.
- Вставьте скопированный Private Key в поле секретного ключа.
- В выпадающем списке Environment выберите режим: Sandbox (для тестовых оплат) или Production (для реального приема средств).
- Активируйте переключатель Published для отображения метода оплаты в корзине.
- Нажмите кнопку Save для применения изменений.
3. Сводная таблица параметров LiqPay Integration
Полный перечень параметров конфигурации платежного шлюза LiqPay в Gridbox:
| Параметр / Поле | Описание и функциональное назначение | Формат / Источник |
|---|---|---|
| Title | Название способа оплаты, отображаемое покупателю при оформлении заказа на странице чекаута. | Текстовая строка |
| Public Key | Публичный ключ аутентификации магазина, полученный в личном кабинете LiqPay. | i00000000000 (Строка) |
| Private Key | Секретный закрытый ключ для цифровой подписи запросов по алгоритму SHA-1. | Секретный токен |
| Environment | Выбор рабочего режима: Sandbox (тестовый режим без реальных списаний) или Production (боевой прием оплат). | Выпадающий список (Sandbox / Production) |
| Published | Переключатель публикации и доступности метода оплаты в корзине интернет-магазина. | Переключатель (Yes/No) |
| Save | Сохранение параметров интеграции платежного шлюза в базе данных Joomla. | Кнопка действия |
LiqPay функционирует на базе процессинга ПриватБанка и сертифицирован по стандарту PCI-DSS Level 1. При переходе на платежный шлюз покупателям доступны все привычные способы оплаты: сканирование QR-кода через Privat24, нативный Apple Pay / Google Pay, а также безопасность по технологии 3D Secure 2.0.
Убедись, что валюта магазина в Store Settings ➝ Currency совпадает с валютой, настроенной в мерчант-аккаунте LiqPay (обычно UAH, USD или EUR). Callback-уведомления (server-to-server) об успешном списании средств обрабатываются Gridbox автоматически по защищенному протоколу, мгновенно переводя статус заказа в «Оплачен» без необходимости ручного подтверждения администратором.