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.

• Регистрация в 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

В вашем расширении (например, интернет-магазине) создайте платеж через 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);

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

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

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

В момент перевода платежа в статус 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