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

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

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

С октября 2025 года сервис Payeer прекратил свою работу. 

код плагина будет вам полезен при разработке собственных платежных плагинов. 

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

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

Установка

• Регистрация в Payeer
  • Зарегистрируйтесь на сайте: https://payeer.com
  • В разделе «Магазин» добавьте свой сайт.
• Скачивание и установка плагина
  • Скачайте исходный код плагина: https://github.com/webitproff/cot-payeerbilling
  • Скопируйте содержимое репозитория в директорию /plugins/payeerbilling/ на своем сайте.
  • Установите плагин через админ-панель Cotonti.
• Настройка плагина В настройках укажите:
  • Идентификатор магазина (shop) — значение, выданное в Payeer.
  • Секретный ключ (key) — секретное слово, заданное в настройках магазина.
  • Валюта платежа (curr) — RUB, USD или EUR.
  • Курс конвертации (rate) — например, 1 (если валюта сайта совпадает с валютой Payeer).

• Настройка 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 на форуме

 Как это работает ?