Инструкция по Подключению к CactusPay

1. Требования для Подключения

Для начала работы с CactusPay вам понадобится:

• Работающий сайт или приложение
• HTTPS-соединение на домене
• Возможность принимать HTTP POST-запросы (для webhook)
• Криптокошелёк USDT TRC-20 для вывода средств

2. Регистрация в Системе

3. Модерация Проекта

После создания проекта он отправляется на модерацию. Наша команда оценивает:

• Тип бизнеса и нишу
• Прогнозируемые обороты
• Соответствие требованиям

Обычно модерация занимает от нескольких часов до 1 дня. После одобрения вы получите уведомление и доступ к API.

4. Получение API Ключей

После одобрения проекта в личном кабинете появятся:

• API Key - публичный ключ для идентификации
• Secret Key - секретный ключ для подписи запросов
• Shop ID - идентификатор вашего магазина

5. Интеграция на Сайт

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

Для создания платежа отправьте POST-запрос на API:

// Пример на PHP
$data = [
    'shop_id' => 'YOUR_SHOP_ID',
    'amount' => 1000, // сумма в рублях
    'order_id' => 'order_12345',
    'description' => 'Оплата заказа #12345',
    'success_url' => 'https://site.ru/success',
    'fail_url' => 'https://site.ru/fail'
];

$sign = hash_hmac('sha256', json_encode($data), $secretKey);
$data['sign'] = $sign;

$response = http_post('https://api.cactuspay.pro/v1/payment/create', $data);

Ответ API

{
    "success": true,
    "payment_id": "pay_abc123",
    "payment_url": "https://pay.cactuspay.pro/pay_abc123",
    "expires_at": "2026-02-03T12:00:00Z"
}

Перенаправьте клиента на payment_url для оплаты.

6. Настройка Webhook

Webhook - это HTTP-уведомление о статусе платежа. Настройте URL для приёма уведомлений в личном кабинете.

Пример webhook-запроса

{
    "event": "payment.success",
    "payment_id": "pay_abc123",
    "order_id": "order_12345",
    "amount": 1000,
    "status": "completed",
    "sign": "..."
}

Обработка webhook

// Проверка подписи
$receivedSign = $_POST['sign'];
unset($_POST['sign']);
$calculatedSign = hash_hmac('sha256', json_encode($_POST), $secretKey);

if ($receivedSign === $calculatedSign) {
    // Подпись верна, обрабатываем платёж
    if ($_POST['status'] === 'completed') {
        // Платёж успешен!
        updateOrderStatus($_POST['order_id'], 'paid');
    }
    echo 'OK';
}

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

Перед запуском в продакшн обязательно протестируйте интеграцию:

• Создайте тестовый платёж на минимальную сумму
• Проверьте корректность webhook-уведомлений
• Убедитесь, что статусы заказов обновляются
• Протестируйте редирект после оплаты

8. Запуск в Продакшн

После успешного тестирования:

1. Переключите API на боевые ключи
2. Настройте webhook на продакшн-URL
3. Проведите финальный тест с реальным платежом
4. Мониторьте первые транзакции в личном кабинете

Поздравляем! Вы успешно интегрировали CactusPay. 🎉