DV.net Docs

Appearance

Как принимать криптоплатежи в OpenCart с помощью расширения платежного шлюза DV.net ​

Предложение оплаты криптовалютой может значительно улучшить ваш магазин на OpenCart, привлечь более широкую аудиторию и обеспечить современную гибкость оплаты. DV.net предлагает надежное решение для обработки криптоплатежей, а его расширение для OpenCart упрощает процесс интеграции. Это руководство предоставляет понятную пошаговую инструкцию по установке и настройке расширения платежного шлюза DV.net на вашем сайте OpenCart.

Требования: ​

  • Активный сайт на OpenCart.
  • Доступ администратора к панели управления OpenCart.
  • Активная учетная запись DV.net.

Шаг 1: Получите расширение DV.net для OpenCart ​

Сначала необходимо скачать файлы расширения. Вы получите их из официального репозитория DV.net на GitHub.

  • Перейдите в официальный репозиторий расширения DV.net для OpenCart: https://github.com/dv-net/dv-opencart.
  • Перейдите на страницу Releases.
  • Скачайте dv-opencart-vX.X.X.ocmod.zip.

Шаг 2: Установите расширение на свой сайт OpenCart ​

OpenCart использует Extension Installer для загрузки и установки пакетов.

  • Войдите в админ-панель OpenCart (например, yourdomain.com/admin).
  • Перейдите в Extensions > Installer в левом меню.
  • Нажмите кнопку Upload.
  • Выберите .zip-файл, который вы скачали в Шаге 1.
  • Дождитесь завершения загрузки и установки. Вы должны увидеть сообщение об успехе.
  • Важно: после установки перейдите в Extensions > Modifications и нажмите синюю кнопку Refresh в правом верхнем углу, чтобы система распознала изменения.
  • Также рекомендуется очистить кэш темы. Перейдите в Dashboard, нажмите синюю иконку шестеренки в правом верхнем углу, затем нажмите кнопки Refresh для Theme Cache и SASS Cache.

Шаг 3: Получите свои API-учетные данные DV.net ​

Чтобы подключить ваш магазин к DV.net, вам понадобятся API Key, API Secret и API URL.

  • Войдите в панель управления вашей учетной записью DV.net.
  • Найдите свой проект или создайте новый.
  • Перейдите в раздел API Keys через Projects -> кнопка Edit для конкретного проекта (см. obtaining-api-key-and-secret.md в файлах документации).
  • Вы увидите API key и secret key. При необходимости вы можете сгенерировать их заново.
  • В разделе ниже укажите URL-адреса для вебхуков. По сути, вам понадобится вебхук только для успешного платежа.

Шаг 4: Настройте шлюз DV.net в OpenCart ​

Теперь настройте способ оплаты в админ-панели OpenCart.

  • В панели OpenCart перейдите в Extensions > Extensions.
  • В выпадающем меню "Choose the extension type" выберите Payments.
  • Прокрутите список до "DV.net Gateway". Нажмите зеленую кнопку Install (+), если он еще не установлен, затем нажмите синюю кнопку Edit (карандаш).
  • Откроется страница настройки DV.net. Заполните следующие поля:
  • API URL: Вставьте API URL из Шага 3.
  • API Key: Вставьте API Key из Шага 3.
  • API Secret: Вставьте API Secret из Шага 3.

Шаг 5: Настройте вебхук в вашей учетной записи DV.net ​

Ваш магазин теперь настроен на отправку платежных запросов в DV.net. Последний шаг — настроить вебхук, чтобы DV.net мог отправлять обновления статуса платежей (например, "Paid" или "Failed") обратно в ваш магазин.

  1. Вернитесь в панель управления вашей учетной записью DV.net.
  2. Перейдите в раздел Webhooks или Developer.
  3. Создайте новый вебхук.
  4. Payload URL: Это самый важный пункт. Уникальный URL вебхука вашего магазина: https://example.com/wc-api/dv_gateway/ (Не забудьте заменить example.com на ваш реальный адрес сайта. Убедитесь, что используется https://).
  5. Укажите адрес для вашего вебхука здесь (для woo это что-то вроде https://example.com/index.php?route=extension/payment/dv_gateway/callback) и нажмите Create.
  6. Events: Если будет предложено, выберите события, за которыми должен следить вебхук. Вам следует включить все события, связанные с платежами, такие как:
    1. Confirmed payment
    2. Unconfirmed payment (i.e when customer will send their payment via BTC and )
    3. Processing withdrawal (currently unsupported by this integration)
  7. Сохраните и активируйте вебхук в панели DV.net.

Шаг 6: Протестируйте интеграцию! ​

  • Интеграция DV.net с OpenCart теперь должна быть завершена! Очень важно выполнить тестовую транзакцию.
  • Посетите витрину вашего магазина OpenCart.
  • Добавьте товар в корзину.
  • Пройдите процесс оформления заказа.
  • При выборе способа оплаты выберите "DV.net Gateway" (или заголовок, указанный в настройках; в OpenCart он часто фиксированный).
  • Подтвердите заказ. Вас должно перенаправить на платежную страницу DV.net.
  • Настоятельно рекомендуется: выполните небольшую реальную транзакцию. После успешной оплаты на DV.net вернитесь в админ-панель OpenCart > Sales > Orders. Убедитесь, что статус тестового заказа автоматически изменился с вашего статуса "Pending" на статус "Paid" (например, "Processing" или "Complete"). Если статус заказа обновляется корректно без ручного вмешательства — настройка успешна! Теперь клиенты могут оплачивать заказы криптовалютой через DV.net в вашем магазине на OpenCart.