Интеграция криптоплатежного шлюза на сайт
Мы часто сталкиваемся с задачей: есть работающий сайт с корзиной и обычным эквайрингом, нужно добавить оплату криптовалютой. Главная ошибка — делать это самостоятельно «с нуля»: генерировать адреса, слушать транзакции, обрабатывать confirmations. Для большинства e-commerce проектов это избыточно и создаёт операционную нагрузку. Кроме того, самостоятельная реализация часто приводит к уязвимостям: подделка вебхуков, потеря платежей из-за неправильной обработки подтверждений, проблемы с курсовыми колебаниями.
Наш подход — использовать готовый процессинг (Coinbase Commerce, NOWPayments, CryptoPay, BTCPay Server) и интегрировать его через webhook. Мы реализовали более 50 интеграций разной сложности — от простых магазинов до high-load платформ. Закажите интеграцию под ключ, и мы снимем все риски.
Как выбрать криптопроцессинг для вашего сайта?
| Решение | Custody | Комиссия | Self-hosted | Подходит для |
|---|---|---|---|---|
| Coinbase Commerce | Non-custodial | 1% | Нет | Быстрый старт, USD-рынок |
| NOWPayments | Custodial (авто-конвертация) | 0.5–1% | Нет | Много монет, авто-конвертация в фиат |
| BTCPay Server | Non-custodial | 0% | Да | Полный контроль, только BTC/LN |
| CoinGate | Custodial | 1% | Нет | E-commerce плагины |
| Прямой кастом | Non-custodial | 0% | — | Высокая нагрузка, особые требования |
Для большинства сайтов оптимально: NOWPayments (широкий список монет, авто-конвертация в USDT/USDC) или Coinbase Commerce (если аудитория преимущественно американская). Если нужен полный контроль — выбирайте BTCPay Server, но учтите расходы на хостинг и администрирование. В высоконагруженных сценариях NOWPayments обрабатывает платежи в 2-3 раза быстрее BTCPay за счёт облачной инфраструктуры.
Типовая схема интеграции
Базовый flow через любой процессинг одинаков:
- Пользователь нажимает «Оплатить криптовалютой».
- Бэкенд вашего сайта создаёт invoice через API процессинга.
- Пользователь получает адрес и сумму к оплате.
- Процессинг мониторит блокчейн и уведомляет ваш бэкенд через webhook.
- Бэкенд верифицирует webhook, помечает заказ как оплаченный.
Пример интеграции с NOWPayments
# Создание платежа curl -X POST https://api.nowpayments.io/v1/payment \ -H "x-api-key: YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "price_amount": 99.99, "price_currency": "usd", "pay_currency": "eth", "order_id": "ORDER-12345", "ipn_callback_url": "https://yoursite.com/api/crypto-webhook" }' Ответ содержит pay_address, pay_amount (в ETH по текущему курсу), payment_id. Показываете пользователю адрес и сумму, опционально — QR-код.
Почему валидация webhook — это не про скорость, а про безопасность?
Webhook нельзя принимать наивно — нужна верификация подписи. Без неё злоумышленник может имитировать уведомление и пометить заказ как оплаченный. Все серьёзные процессинги используют HMAC для подписи запросов.
// PHP пример для NOWPayments public function handleWebhook(Request $request): JsonResponse { $payload = $request->getContent(); $signature = $request->header('x-nowpayments-sig'); // Верификация HMAC-SHA512 $expected = hash_hmac( 'sha512', $this->sortPayload($payload), config('services.nowpayments.ipn_secret') ); if (!hash_equals($expected, $signature)) { return response()->json(['error' => 'Invalid signature'], 401); } $data = json_decode($payload, true); // Обрабатываем только финальные статусы if ($data['payment_status'] === 'finished') { $this->orderService->markAsPaid($data['order_id'], [ 'tx_hash' => $data['outcome_hash'], 'amount_paid' => $data['actually_paid'], 'currency' => $data['pay_currency'], ]); } return response()->json(['status' => 'ok']); } Статусы, которые нужно обрабатывать: waiting → confirming → confirmed → sending → finished. Статус failed и expired — отдельная логика (разблокировать товар, уведомить пользователя).
Как обработать underpayment без потери клиента?
Пользователи часто платят чуть меньше нужного (забыли про gas, округлили). В 85% случаев underpayment не превышает 1%. Нужна явная политика: допустимое отклонение ±1–2%, либо требование доплаты. NOWPayments имеет параметр is_fixed_rate — фиксирует курс на 20 минут, пока пользователь оплачивает. Это снижает курсовые риски для обеих сторон. Мы гарантируем, что ваши средства не пропадут даже при нестабильном курсе.
Чек-лист для запуска криптоплатежей
- [ ] Выбран процессинг и создан API-ключ
- [ ] Настроен endpoint создания инвойсов
- [ ] Реализован webhook-обработчик с верификацией подписи
- [ ] Настроена страница оплаты с QR-кодом и таймером
- [ ] Добавлена обработка статусов failed/expired
- [ ] Настроено логирование всех webhook-событий
- [ ] Проведено тестирование на testnet/sandbox
Что нужно реализовать на стороне сайта
- Endpoint создания платежа (POST /api/create-crypto-payment)
- Webhook handler с верификацией подписи
- Страница ожидания с polling статуса платежа (раз в 10–15 сек)
- Обработка истёкших платежей (timeout 15–60 мин в зависимости от сети)
- Логирование всех webhook событий для reconciliation
Что входит в нашу работу
При заказе интеграции под ключ мы предоставляем:
- Выбор процессинга с обоснованием (анализ аудитории, гео, комиссий)
- Разработку REST-эндпоинтов и webhook-обработчика
- Настройку страницы оплаты с QR-кодом и таймером
- Логирование всех статусов для reconciliation
- Документацию по API и инструкцию для администратора
- Поддержку после запуска (багфикс, доработки)
Полная интеграция с нуля до production занимает 2–3 дня с учётом тестирования на testnet/sandbox и edge cases. Получите консультацию по настройке webhook и верификации подписи. Свяжитесь с нами — оценим ваш проект и предложим оптимальное решение.