Разработка собственного донат-магазина для сервера SAMP / MTA / CRMP: Подключение платёжек и защита от фейк-вебхуков
Создание собственного проекта рано или поздно упирается в необходимость монетизации для оплаты аренды хостинга, VDS и работы разработчиков. В этой статье мы разберем архитектуру правильного донат-магазина, подключение популярных платежных агрегаторов и методы защиты от самых частых атак на вебхуки.
Многие начинающие веб-разработчики совершают критическую ошибку: начисляют донат-валюту или привилегии прямо в браузере игрока после успешного редиректа с формы оплаты.
Правильная архитектура выглядит так:
Главный элемент безопасности — проверка цифровой подписи запроса, которую присылает платёжка. Это гарантирует, что запрос пришел именно от кассы, а не от злоумышленника.
После того как скрипт подтвердил оплату, вы можете выдать товар двумя путями:
Создание собственного проекта рано или поздно упирается в необходимость монетизации для оплаты аренды хостинга, VDS и работы разработчиков. В этой статье мы разберем архитектуру правильного донат-магазина, подключение популярных платежных агрегаторов и методы защиты от самых частых атак на вебхуки.
1. Как устроена безопасная схема авто-доната
Многие начинающие веб-разработчики совершают критическую ошибку: начисляют донат-валюту или привилегии прямо в браузере игрока после успешного редиректа с формы оплаты.
Правильная архитектура выглядит так:
- Игрок заполняет форму на сайте (указывает ник, выбирает товар) -> Сайт создает запись в БД со статусом
pending(ожидает оплаты). - Сайт перенаправляет игрока на защищенный шлюз платежной системы (FreeKassa, ЮKassa, PayKassa и др.).
- Платежная система обрабатывает транзакцию и отправляет секретный фоновый запрос (Webhook / Result URL) на ваш сервер.
- Ваш сервер проверяет подпись запроса (Sign/Hash). Если подпись верна — статус меняется на
paid, а игровой сервер выдает товар.
2. Пример обработки Webhook на PHP
Главный элемент безопасности — проверка цифровой подписи запроса, которую присылает платёжка. Это гарантирует, что запрос пришел именно от кассы, а не от злоумышленника.
PHP:
<?php
// Секретный ключ, полученный в личной кабинете кассы
$secret_word = 'YOUR_SECRET_KEY_HERE';
// Получаем данные от платежной системы
$merchant_id = $_POST['MERCHANT_ID'] ?? '';
$amount = $_POST['AMOUNT'] ?? '';
$order_id = $_POST['MERCHANT_ORDER_ID'] ?? '';
$sign = $_POST['SIGN'] ?? '';
// Формируем контрольную подпись по алгоритму кассы (пример для MD5/SHA256)
$my_sign = md5($merchant_id . ':' . $amount . ':' . $secret_word . ':' . $order_id);
// 1. Проверяем валидность подписи
if (hash_equals(strtolower($my_sign), strtolower($sign))) {
// 2. Проверяем IP-адрес отправителя (IP-диапазон кассы)
$allowed_ips = ['168.119.157.136', '168.119.157.137']; // Пример IP кассы
if (!in_array($_SERVER['REMOTE_ADDR'], $allowed_ips)) {
die('Forbidden IP');
}
// 3. Выполняем зачисление в БД
// UPDATE users SET donate_coins = donate_coins + $amount WHERE nickname = ...
echo "YES"; // Отвечаем кассе, что платеж принят
} else {
echo "Bad sign";
}
?>
3. Главные векторы атак и способы защиты
| Уязвимость / Атака | Метод противодействия |
|---|---|
| Фейковый Webhook (Man-in-the-Middle) | Строгая проверка хеша подписи (hash_equals) и фильтрация входящих IP-адресов. |
| Повторная отправка платежа (Replay Attack) | Каждый транзакции присваивается уникальный order_id. В БД перед начислением проверяется, не был ли заказ уже обработан. |
| Подмена суммы (Race Condition) | Сумма платежа проверяется с суммой заказа, сохраненной в вашей БД до отправки на кассу. |
| SQL-инъекции в никнеймах | Использование подготавливаемых запросов (Prepared Statements / PDO) при работе с базами данных SAMP/MTA. |
4. Интеграция авто-выдачи с XenForo и игровым сервером
После того как скрипт подтвердил оплату, вы можете выдать товар двумя путями:
- Через MySQL напрямую: Запись баланса в таблицу игроков или изменение `user_group_id` в базе данных XenForo для автоматической выдачи VIP-роли на форуме.
- Через RCON / Sockets: Отправка команды на игровой сервер (например,
givedonate Nick_Name 500) в реальном времени, если игрок находится в сети.
Какими платежными шлюзами пользуетесь вы? Делитесь опытом работы с единицами эквайринга, комиссиями и настройкой авто-доната в комментариях!