Если вы уже изучаете OxaPay, Скорее всего, вы ищете надёжный способ принимать криптовалютные платежи на своём сайте — без сложностей, задержек и дополнительных рисков. Это руководство основано на реальном опыте внедрения и точно покажет, как начать работу, будь то настройка платёжной ссылки, установка плагина или интеграция полного API.
Прежде чем начать: Контрольный список перед интеграцией
Прежде чем приступать к интеграции, убедитесь, что у вас есть все необходимое:
- Функциональный веб-сайт (WordPress, SaaS или собственный бэкэнд).
- Доступ администратора для установки плагинов или редактирования кода бэкенда.
- Цель бизнеса: принимаете ли вы криптовалюту за товары, подписку или пожертвования?
- Ваш аккаунт OxaPay создан и верифицирован (не требуется KYC/KYB).
- Необязательно: Доступ для разработчиков, если вы планируете использовать API.
Убедитесь, что ваша платформа и команда технически готовы к поддержке криптовалютных транзакций непосредственно на вашем сайте, с участием или без участия разработчиков.
🧭 Совет: если вы не уверены, какой метод использовать (плагин или API), посмотрите сравнительную таблицу в конце статьи.
Шаг 1: Создайте аккаунт OxaPay и получите доступ к API
Перед началом интеграции вам понадобится верифицированная учетная запись OxaPay. Вот что нужно сделать:
- Зарегистрируйтесь на сайте oxapay- Не требуется KYC/KYB.
- Перейдите на панель управления > Настройки API.
- Скопируйте свой API-ключ торговца и запишите свой секрет обратного звонка.
Эти учетные данные являются основой безопасного соединения между вашим сайтом и OxaPay и первым шагом к возможности принимать криптовалютные платежи на вашем сайте с полным контролем.
🔒 Совет разработчика:
Для повышения безопасности периодически меняйте ключи API и храните их в переменных среды, а не в кодовой базе.
Безопасность платежных API: Лучшие практики по обеспечению безопасности ключей API
Шаг 2: Выберите правильный метод интеграции
OxaPay поддерживает несколько способов интеграции криптовалютных платежей на ваш сайт. Выбирайте в зависимости от типа вашего сайта и технических возможностей:
1. Интеграция с плагинами (код не требуется)
Идеально подходит для платформ электронной коммерции и биллинга, таких как WooCommerce, WHMCS и Blesta. OxaPay также поддерживает другие платформы, изучите все плагины и интеграции для криптовалютных платежей для вашего бизнеса.
Как это сделать:
- Установите плагин из Страница документации OxaPay.
- Вставьте свой ключ API в настройки.
- Установите желаемые монеты и время ожидания платежа.
- Готово. Вы в прямом эфире.
⏱ Время установки: ~15 минут
2. Интеграция API (для разработчиков)
Если вы используете пользовательскую платформу, вы будете использовать REST API OxaPay для создания счетов-фактур и обрабатывать транзакции с полным контролем бэкэнда.
Основные конечные точки, которые вы будете использовать:
- POST /api/create-invoice
- GET /api/check-invoice
- Вебхук: Обратный вызов POST с проверкой HMAC
Основной поток:
- Ваш бэкэнд генерирует счет-фактуру с указанием суммы, типа монеты и URL-адреса перенаправления.
- OxaPay возвращает уникальный платежный адрес.
- Клиент платит через кошелек или QR-код.
- OxaPay подтверждает транзакцию и отправляет подписанный веб-хук на ваш URL-адрес обратного вызова.
🧩 Интеграция обычно занимает около 80-150 строк кода бэкенда.
Оба метода разработаны для того, чтобы помочь вам надёжно принимать криптовалютные платежи на вашем сайте, независимо от того, используете ли вы плагин или разрабатываете полностью настраиваемый бэкенд. Чтобы подробнее узнать о работе API и о том, что можно с его помощью создать, ознакомьтесь с нашим полным руководством. API криптоплатежей и примеры использования.
📦 Уголок разработчика - пример кода Python
импорт запросов
import hmac, hashlib
API_KEY = "your-api-key"
CALLBACK_SECRET = "your-secret"
данные счета = {
"сумма": 49.99,
"валюта": "USDT",
"callback_url": "https://your-site.com/payment-callback"
}
response = requests.post("https://api.oxapay.com/api/create-invoice", json=invoice_data, headers={"Authorization": API_KEY})
print(response.json())
def verify_signature(data, signature):
return hmac.new(CALLBACK_SECRET.encode(), data.encode(), hashlib.sha256).hexdigest() == signature
📘 Упрощенный обратный звонок:
Убедитесь, что конечная точка обратного вызова общедоступна и возвращает HTTP 200 OK.
Вы можете регистрировать входящие ПОСТ запросы для проверки структуры и тестирования логики проверки подписи.
Шаг 3: Настройте поведение при оплате
Вы можете настроить, как OxaPay обрабатывает платежи на вашем сайте:
- Автоматическое преобразование: Мгновенная конвертация полученных криптовалют в USDT .
- Тайм-аут счета-фактуры: Определите срок действия счетов-фактур.
- Восстановление недоплаченных сумм: Дайте пользователям возможность завершить платежи, если они отправили меньше, чем требуется.
- Язык и брендинг: Настройте название, логотип и язык страницы оплаты.
Эти настройки доступны через приборную панель или параметры API при создании счета-фактуры.
Тонкая настройка этих параметров обеспечит вашим клиентам единообразный опыт приема криптовалютных платежей на вашем сайте в соответствии с вашими брендинговыми и операционными потребностями.
⚙️ Продвинутый совет для разработчиков:
Чтобы динамически внедрять брендинг, передайте поля custom_logo_url, language и redirect_after при создании счета через API.
🔗 Заинтересованы в создании фирменной криптокассы? Узнайте больше в Как создать собственный платежный шлюз.
Шаг 4: протестируйте интеграцию перед запуском
Всегда тестируйте свою реализацию, используя Песочница OxaPay окружающая среда:
- Создайте тестовые счета-фактуры с фиктивными суммами.
- Моделируйте подтверждения платежей с помощью тестовых кошельков.
- Убедитесь, что обратные вызовы достигают вашего сервера и запускают правильную логику (например, помечают заказ как оплаченный).
🔐 Совет разработчика:
Используйте подпись HMAC, отправленную в каждом обратном вызове, для проверки подлинности с помощью вашего секрета обратного вызова. Записывайте в журнал неудачные попытки проверки, чтобы отслеживать возможные злоупотребления.
🛠 Устранение общих неполадок:
- Срок действия счета истек? Увеличьте время ожидания в настройках или разрешите быструю регенерацию.
- Недооплаченная сделка? Включите функцию "Восстановление недоплаченных сумм", чтобы клиенты могли завершить все остальное.
- Не получен обратный звонок? Убедитесь, что конечная точка вашего сервера является публичной и корректно принимает POST-запросы.
🧪 Совет по тестированию:
Вы можете имитировать платежи с помощью тестовых кошельков, таких как TronLink или MetaMask, в тестовых сетях. OxaPay предоставляет специальный режим песочницы для безопасных экспериментов. Правильное тестирование снижает количество отказов и гарантирует, что ваша система действительно готова к приему криптовалютных платежей на вашем сайте в реальных условиях.
Шаг 5: Начните принимать криптовалюту на своем сайте
После завершения тестирования:
- Переведите ваши счета из режима "песочницы" в режим реального времени.
- Отслеживайте подтверждения платежей на приборной панели OxaPay.
- Теперь вы готовы принимать криптовалютные платежи на своем сайте — безопасно, в режиме реального времени и с полной прозрачностью через панель управления OxaPay.
🌟 Что испытывают ваши клиенты
- Чистый, удобный для мобильных устройств экран оформления заказа.
- Отображение QR-кода и адреса кошелька в режиме реального времени.
- Таймер обратного отсчета для срока действия счета.
- Автоматическое подтверждение успешной оплаты.
✨ Эти визуальные и функциональные элементы повышают доверие и снижают количество отсевов.
💸 Ваш первый криптоплатеж (прохождение)
Вот как выглядит поток для вашей самой первой транзакции:
- Вы создаете счет-фактуру с помощью плагина или API.
- Клиент видит полностью настроенную страницу оплаты.
- Они платят с помощью своего криптокошелька (сканируют QR или вставляют адрес).
- OxaPay подтверждает транзакцию и обновляет вашу систему через обратный звонок.
- Вы увидите подтверждение на панели управления.
⚡ Большинство платежей на основе TRON или BSC подтверждаются менее чем за 60 секунд.
🧩 Советы для долгосрочного успеха
- Включите функцию автоматического вывода средств на ваш кошелек или в холодное хранилище.
- Еженедельно проверяйте историю операций для сверки счетов-фактур.
- Используйте отслеживание недоплаченных сумм для повышения коэффициента возврата.
- Проинформируйте свою службу поддержки о статусах платежей и сроках действия счетов.
- Настройте брендинг и языки в зависимости от местоположения пользователя.
📊 Сравнение методов интеграции
| Метод | Время установки | Сложность | Лучшее для |
| Плагин | ~15 мин | Низкий | WooCommerce, WHMCS, Blesta |
| REST API | 1-3 часа | Середина | SaaS, пользовательские веб-приложения, бэкэнд |
Заключение: Создан для простоты. Готов к масштабированию.
С OxaPay вы можете принимать криптовалютные платежи на своём сайте без написания сложного блокчейн-кода и необходимости обращаться к сторонним кастодианам. Процесс быстрый, безопасный и масштабируемый: от простых плагинов до полного управления через API.
🎯 Готовы к запуску?
Готовы к работе? Начните с Криптовалютный платежный шлюз OxaPay или погрузитесь в наш API-документация чтобы создать индивидуальное решение для вашего бизнеса.
