Как настроить платежную систему FreeKassa

Настройка платежной системы FreeKassa на сайте включает несколько шагов.

FreeKassa — это популярный платежный агрегатор, который поддерживает множество способов оплаты (банковские карты, электронные кошельки, криптовалюты и т.д.). Вот пошаговая инструкция:

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

• Перейдите на сайт FreeKassa.
• Зарегистрируйте аккаунт (выберите тип аккаунта: для физических или юридических лиц).
• Подтвердите email и заполните необходимые данные в личном кабинете.

2. Подключение магазина

• В личном кабинете FreeKassa перейдите в раздел “Магазины”.
• Нажмите “Добавить магазин”.
• Заполните данные:
  • Название магазина.
  • Сайт магазина.
  • Валюта магазина (рубли, доллары, евро и т.д.).
• Сохраните настройки.

3. Получение реквизитов для интеграции

• После создания магазина FreeKassa предоставит вам:
  • ID магазина.
  • Секретный ключ 1.
  • Секретный ключ 2.
• Эти данные понадобятся для настройки платежей на вашем сайте.

4. Настройка платежной формы на сайте

FreeKassa поддерживает несколько способов интеграции:

• Форма оплаты через API.
• Готовая платежная форма.
• Интеграция через CMS (если у вас WordPress, OpenCart и т.д.).

Пример HTML-формы для оплаты:

<form method="get" action="https://pay.freekassa.ru/">
    <input type="hidden" name="m" value="ВАШ_ID_МАГАЗИНА">
    <input type="hidden" name="oa" value="100"> <!-- Сумма оплаты -->
    <input type="hidden" name="o" value="12345"> <!-- Номер заказа -->
    <input type="hidden" name="s" value="ПОДПИСЬ"> <!-- Подпись (см. ниже) -->
    <input type="hidden" name="currency" value="RUB"> <!-- Валюта -->
    <input type="hidden" name="lang" value="ru"> <!-- Язык -->
    <button type="submit">Оплатить через FreeKassa</button>
</form>

Как сгенерировать подпись (s):

Подпись формируется по формуле:

MD5(ID магазина + сумма + секретный ключ 1 + номер заказа)

Пример на PHP:

$merchant_id = 'ВАШ_ID_МАГАЗИНА';
$secret_key = 'ВАШ_СЕКРЕТНЫЙ_КЛЮЧ_1';
$order_id = '12345';
$amount = '100';
$signature = md5($merchant_id . ':' . $amount . ':' . $secret_key . ':' . $order_id);

5. Настройка уведомлений о платежах (Callback)

• В личном кабинете FreeKassa перейдите в раздел “Настройки магазина”.
• Укажите URL для уведомлений (например, https://вашсайт.ru/freekassa_callback.php).
• Настройте метод передачи данных (GET или POST).
• Сохраните изменения.

Пример обработки Callback на PHP:

$merchant_id = 'ВАШ_ID_МАГАЗИНА';
$secret_key_2 = 'ВАШ_СЕКРЕТНЫЙ_КЛЮЧ_2';

$sign = md5($merchant_id . ':' . $_REQUEST['AMOUNT'] . ':' . $secret_key_2 . ':' . $_REQUEST['MERCHANT_ORDER_ID']);

if ($sign != $_REQUEST['SIGN']) {
    die('Неверная подпись');
}

// Обработка успешного платежа
$order_id = $_REQUEST['MERCHANT_ORDER_ID'];
$amount = $_REQUEST['AMOUNT'];

// Ваш код для обновления статуса заказа
echo 'OK';

6. Тестирование

• В личном кабинете FreeKassa включите тестовый режим.
• Проверьте, что платежи корректно проходят, а уведомления обрабатываются.

7. Переход в боевой режим

• После успешного тестирования отключите тестовый режим.
• Убедитесь, что все настройки корректны.

8. Дополнительные возможности

• Виджеты оплаты: FreeKassa предоставляет готовые кнопки и виджеты для интеграции.
• API: Если у вас сложная логика оплаты, используйте API FreeKassa для более гибкой настройки.
• Поддержка: Если возникнут вопросы, обратитесь в службу поддержки FreeKassa.

Если у вас есть CMS (например, WordPress, OpenCart, Joomla), вы можете найти готовые модули или плагины для интеграции FreeKassa. Это значительно упростит процесс настройки.