Настройка модуля «PayBox»

Модуль приема платежей через PayBox.money (Казахстан) Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

Когда стоит подключать модуль

• Площадкам, которые принимают оплату за объявления, заказы, услуги, бронирования или дополнительные опции.
• Владельцам, которым нужно видеть подтвержденный статус платежа внутри ADWOS CMS, а не сверять оплаты вручную.
• Командам, которые хотят сначала проверить тестовую оплату, а затем спокойно включить боевой режим.

Что изменится на сайте

• Пользователь выбирает способ оплаты «PayBox» в платежном сценарии площадки.
• ADWOS CMS получает статус оплаты и может продолжить заказ, бронирование или покупку услуги.
• Владелец площадки разделяет тестовый и боевой режим, чтобы не смешивать проверочные платежи с реальными.
• Ошибки оплаты, отмены и webhook-события проще проверять в одном понятном сценарии.

Что подготовить заранее

Подготовьте доступы и тестовые данные до включения модуля. Так вы проверите сценарий спокойно и не затронете реальные заказы, пользователей или публичные страницы.

• Создайте кабинет мерчанта у провайдера «PayBox» и убедитесь, что он готов к тестовым операциям.
• Подготовьте секретные ключи, webhook-секрет, валюту и адреса страниц успешной оплаты и отмены.
• Проверьте, есть ли у провайдера отдельные ключи для тестового и боевого режима.
• Решите, какой сценарий будет первым тестом: заказ, бронирование, платное объявление или покупка услуги.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «PayBox» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

В настройках модуля заполняйте только те значения, которые относятся к вашему проекту. Секретные ключи храните в защищенных полях и не переносите их в открытые тексты, письма или инструкции для пользователей.

• «URL после неуспешной оплаты». Укажите полный адрес страницы, callback или webhook, который должен использовать внешний сервис. Значение по умолчанию: /payment/fail.
• «Merchant ID». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Поле обязательное.
• «Secret Key». Обязательное секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах.
• «URL после успешной оплаты». Укажите полный адрес страницы, callback или webhook, который должен использовать внешний сервис. Значение по умолчанию: /payment/success.
• «Тестовый режим». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true.

После сохранения обновите страницу панели управления и убедитесь, что модуль остался включенным. Если есть тестовый режим, сначала завершите проверку в нем, а уже потом переходите на боевые ключи.

Проверка перед запуском

• Создайте тестовый заказ или сделку и выберите оплату через «PayBox».
• Проведите тестовую оплату в кабинете провайдера или через тестовую карту, если она доступна.
• Проверьте в ADWOS CMS, что статус заказа изменился автоматически.
• Отдельно проверьте отказ, отмену оплаты и повторный webhook, чтобы увидеть поведение при ошибке.

Частые ошибки

• Статус заказа не меняется после оплаты. Проверьте webhook-секрет, адрес webhook и совпадение тестового или боевого режима.
• Пользователь не возвращается на сайт. Проверьте URL успешной оплаты и URL отмены в настройках модуля и кабинете провайдера.
• Провайдер отклоняет платеж. Проверьте валюту, страну мерчанта, ограничения аккаунта и тестовые реквизиты.
• На сайте не виден способ оплаты. Убедитесь, что модуль включен и доступен для нужного платежного сценария.

Когда тест проходит без ошибок, оставьте модуль включенным и зафиксируйте, какие данные использовались для проверки. Это поможет быстро восстановить настройку после обновления или смены ключей.