Раздел PayFast Integration в конструкторе сайтов Gridbox для Joomla посвящен подключению и конфигурированию платежного шлюза PayFast в интернет-магазине (Store App). Интеграция с PayFast открывает возможность безопасного приема онлайн-платежей в национальной валюте ЮАР (ZAR) через банковские карты Visa и MasterCard, мгновенные межбанковские переводы Instant EFT, QR-сервисы SnapScan и Zapper, а также цифровые кошельки Masterpass.
1. Получение учетных данных API PayFast (Getting PayFast API Credentials)
Для подключения интернет-магазина к шлюзу PayFast вам понадобятся: Merchant ID (идентификатор продавца), Merchant Key (ключ продавца) и Passphrase (секретная кодовая фраза):
- Войдите в личный кабинет мерчанта на портале PayFast Merchant Dashboard (для боевого режима) или в тестовый кабинет разработчиков PayFast Sandbox Dashboard (официальный сайт платформы — PayFast.io / PayFast.co.za, документация разработчиков — PayFast Developer Documentation).
- На главной странице панели управления (Dashboard) в блоке информации о мерчанте найдите и скопируйте ваши учетные данные:
- Merchant ID: Уникальный цифровой номер мерчанта;
- Merchant Key: Секретный ключ продавца для аутентификации запросов.
- В главном меню кабинета перейдите в раздел Settings ➝ Integration (Настройки ➝ Интеграция).
- В блоке Security Passphrase задайте или скопируйте секретную кодовую фразу (Passphrase), которая используется для генерации цифровой подписи MD5 и защиты платежных данных от подделки.
2. Настройка PayFast в панели Gridbox Store (Configuring PayFast in Gridbox)
После получения учетных данных завершите настройку способа оплаты в административной панели сайта:
- В панели управления Gridbox перейдите по пути: Store App ➝ Settings ➝ Payment Methods.
- Нажмите кнопку Add New Item и выберите в списке шлюзов PayFast.
- В поле Title укажите публичный заголовок для покупателей (например, Оплата онлайн: PayFast (Карты, Instant EFT, SnapScan)).
- Вставьте скопированный Merchant ID в соответствующее поле настроек.
- Вставьте скопированный Merchant Key в поле ключа продавца.
- Вставьте скопированную Passphrase в поле секретной фразы.
- В выпадающем списке Environment выберите режим: Sandbox (для проверки оплат в тестовой песочнице) или Live (для приема реальных платежей).
- Активируйте переключатель Published для отображения метода в чекауте.
- Нажмите кнопку Save для сохранения параметров.
3. Сводная таблица параметров PayFast Integration
Полный перечень параметров конфигурации платежного шлюза PayFast в Gridbox:
| Параметр / Поле | Описание и функциональное назначение | Формат / Источник |
|---|---|---|
| Title | Название способа оплаты, отображаемое клиентам на этапе оформления заказа (Checkout). | Текстовая строка |
| Merchant ID | Уникальный числовой идентификатор мерчанта в системе PayFast. | Числовой ID |
| Merchant Key | Ключ продавца для авторизации платежных сессий. | Буквенно-цифровой токен |
| Passphrase | Секретная фраза безопасности для формирования и сверки цифровой подписи (MD5 Signature). | Секретная строка / Пароль |
| Environment | Выбор рабочей среды: Sandbox (тестовая среда) или Live (боевой прием реальных средств). | Выпадающий список (Sandbox / Live) |
| Published | Статус публикации и доступности метода оплаты в корзине интернет-магазина. | Переключатель (Yes/No) |
| Save | Сохранение параметров интеграции платежного шлюза в базе данных Joomla. | Кнопка действия |
PayFast сертифицирован по стандарту PCI-DSS Level 1. Шлюз поддерживает систему Instant EFT, позволяющую клиентам южноафриканских банков (ABSA, Capitec, FNB, Nedbank, Standard Bank, Investec) совершать прямые межбанковские переводы с мгновенным зачислением без ожидания межбанковского клиринга.
Обязательно убедись, что валюта магазина в Store Settings ➝ Currency установлена как ZAR (Южноафриканский ранд), так как PayFast производит расчеты исключительно в национальной валюте ЮАР. Если в панели PayFast включена опция Passphrase, она строго обязательна к заполнению в настройках Gridbox, иначе сервер отклонит транзакцию из-за несовпадения контрольной суммы подписи (signature validation failed).