PayeerBilling — плагин приема платежей для Cotonti

Описание

PayeerBilling — это платежный плагин для CMS Cotonti (начиная с версии 0.9.26, PHP 8.4+), который интегрирует модуль Payments с платежной системой https://payeer.com.

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

Основные возможности

• Прием платежей через Payeer в валютах RUB, USD, EUR.
• Поддержка криптовалют: BTC, USDT и других, доступных в системе Payeer.
• Интеграция с модулем Payments в Cotonti.
• Автоматическая обработка платежей (webhook).
• Автоматическое изменение статуса платежа в Cotonti:
  • new → новый
  • process → в процессе оплаты
  • paid → оплачен
  • done → завершен
• Редирект пользователя после успешной или неуспешной оплаты.
• Проверка целостности и корректности подписи запроса с помощью SHA-256.
• Возможность указывать курс конвертации валюты сайта к валюте Payeer.

---

Установка

1. Регистрация в Payeer

   • Зарегистрируйтесь на сайте: https://payeer.com
   • В разделе «Магазин» добавьте свой сайт.

2. Скачивание и установка плагина

   • Скачайте исходный код плагина: https://github.com/webitproff/cot-payeerbilling
   • Скопируйте содержимое репозитория в директорию /plugins/payeerbilling/ на своем сайте.
   • Установите плагин через админ-панель Cotonti.

3. Настройка плагина В настройках укажите:

   • Идентификатор магазина (shop) — значение, выданное в Payeer.
   • Секретный ключ (key) — секретное слово, заданное в настройках магазина.
   • Валюта платежа (curr) — RUB, USD или EUR.
   • Курс конвертации (rate) — например, 1 (если валюта сайта совпадает с валютой Payeer).

4. Настройка callback URL в личном кабинете Payeer: Укажите следующие адреса:

   • URL успешной оплаты:

     https://вашсайт.com/index.php?e=payeerbilling&m=success
     

   • URL неуспешной оплаты:

     https://вашсайт.com/index.php?e=payeerbilling&m=fail
     

   • URL обработчика (webhook):

     https://вашсайт.com/index.php?r=payeerbilling
     

---

Использование

1. Создание платежа

В вашем расширении (например, интернет-магазине) создайте платеж через API модуля Payments:

$amount = 500; // сумма в валюте сайта
$area = 'orders'; // тип платежа
$options = [
    'desc' => 'Оплата заказа №123',
    'code' => $orderId,
    'redirect' => cot_url('orders', ['m' => 'view', 'id' => $orderId], '', true)
];

cot_payments_create_order($area, $amount, $options);

2. Выбор способа оплаты

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

3. Перенаправление в Payeer

Плагин формирует защищенную форму с подписью и перенаправляет пользователя в платежную систему.

4. Обработка статуса

• При успешной оплате Payeer отправляет уведомление (webhook) на сайт.
• Плагин проверяет подпись и переводит платеж в статус paid.
• Если был указан redirect при создании платежа — пользователь будет перенаправлен туда.

5. Автоматическая активация услуг

В момент перевода платежа в статус paid вызывается хук payments.payment.success. Ваше расширение должно обрабатывать этот хук для активации услуги (например, подтверждения заказа).

---

Языковые файлы

Плагин поддерживает локализацию. В русском языке доступны сообщения об оплате, ошибках и тексты форм.

---

Совместимость

• Cotonti Siena 0.9.26+
• PHP 8.4+
• Модуль payments (обязателен)

---

Авторы

• CMSWorks
• webitproff — GitHub

---

Лицензия

Плагин распространяется под лицензией BSD.

---

Репозиторий

Исходный код GitHub: 👉 https://github.com/webitproff/cot-payeerbilling

Помощь и поддержка

Вопросы и обсуждение плагина, а также говорим о самой платежной системе payeer на форуме