VibeFox DPO for WooCommerce — Помощь

Требования

WordPress: 6.2 или новее.

WooCommerce: 8.0 или новее, установлен и активен. Без него плагин не активируется.

PHP: 8.0 или новее.

Учётная запись DPO Pay: вам нужны Company Token и Service Type ID вашей учётной записи мерчанта DPO. DPO выдаёт их при открытии учётной записи; получите их у своего менеджера в DPO или на dpogroup.com. DPO также может предоставить тестовую учётную запись с собственным токеном и service type. Отдельного тестового сервера нет: DPO использует один и тот же адрес API для тестовых и рабочих учётных записей, а учётная запись выбирается по токену.

Валюта: валюта магазина должна поддерживаться вашей учётной записью DPO, например USD, EUR, ZAR, KES, UGX, TZS, RWF, GHS, NGN, ZMW, XOF или AED. DPO принимает не более 2 десятичных знаков, поэтому суммы заказа с 3 десятичными знаками (например, KWD 12.345) оплатить нельзя.

Лицензионный ключ VibeFox: приобретается на vibefox.net. Один ключ работает на одном домене.

Установка

1. В WordPress перейдите в Plugins > Add New > Upload Plugin, выберите ZIP-файл плагина и нажмите Install Now. Также можно загрузить папку wcp_dpo_pay в /wp-content/plugins/ по FTP.

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Payments > DPO Pay > Manage, либо нажмите Settings под названием плагина на странице плагинов.

4. Введите свой лицензионный ключ VibeFox в блоке лицензии в верхней части страницы и нажмите Activate.

5. Введите тестовые и/или рабочие Company Token и Service Type (см. Настройка).

6. Отправьте URL push-уведомления, показанный на странице настроек, в поддержку DPO и попросите настроить его для вашей учётной записи.

7. Включите Enable/Disable. Оформите тестовый заказ в тестовом режиме, затем снимите флажок Test mode, чтобы принимать реальные платежи.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > DPO Pay. Если платёжный шлюз включён, но Company Token или Service Type выбранного режима не заполнены, страница предупреждает, что способ оплаты скрыт при оформлении заказа, а при сохранении появляется та же ошибка. Пока включён тестовый режим, страница показывает Test mode is on: payments are created with the test account credentials.

Общие

Enable/Disable: Enable DPO Pay включает или отключает способ оплаты. По умолчанию: выключено.

Title: название способа оплаты, которое покупатели видят при оформлении заказа. По умолчанию: DPO Pay.

Description: текст, показанный под способом оплаты при оформлении заказа. По умолчанию: Pay securely by card or mobile money on the DPO Pay payment page.

Учётные данные API

DPO выдаёт Company Token и Service Type ID для вашей учётной записи мерчанта и отдельные — для тестовой учётной записи. Получите их у своего менеджера в DPO или на dpogroup.com.

Test mode: Use the test account credentials below. Когда включено, новые платежи создаются с тестовым Company Token и Service Type. По умолчанию: включено. Снимите флажок, чтобы принимать реальные платежи с рабочими учётными данными. Проверки статуса существующих заказов всегда используют учётную запись, с которой был создан платёж.

Test Company Token: Company Token вашей тестовой учётной записи DPO.

Test Service Type: числовой Service Type ID вашей тестовой учётной записи DPO.

Live Company Token: Company Token вашей рабочей учётной записи мерчанта DPO.

Live Service Type: числовой Service Type ID вашей рабочей учётной записи мерчанта DPO.

Service Type должен быть числом. Любое другое значение не сохраняется: страница показывает ошибку и оставляет предыдущее значение. При обновлении с версии 1.0 учётные данные этой версии также копируются в тестовые поля.

Уведомления об оплате

Push-уведомление сразу сообщает вашему магазину, что платёж выполнен, даже если покупатель закрыл браузер после оплаты. В этом разделе показан URL push-уведомления. Он выглядит так: https://your-site/wc-api/dpo_pay_notify/. Он не настраивается в панели управления: попросите поддержку DPO настроить этот URL для вашей учётной записи.

Push-уведомления DPO не подписаны, поэтому их содержимому никогда не доверяют. Плагин использует их только для поиска заказа, а затем сам проверяет платёж в DPO. Без URL push-уведомления заказы всё равно подтверждаются при возвращении покупателя в магазин и автоматическими повторными проверками через 15 минут после перенаправления и после истечения срока оплаты.

Заказы

Successful payment status: статус заказа после проверенной успешной оплаты. Статус устанавливается сразу, без второго изменения статуса.

Дополнительно

Logging: Enable logging записывает вызовы API и уведомления в WooCommerce > Status > Logs, источник wcp_dpo_pay. Ошибки записываются всегда. Токены маскируются, данные покупателя не записываются. По умолчанию: выключено.

Delete data: Delete all plugin data when the plugin is deleted. При удалении удаляет настройки, данные DPO, сохранённые в заказах, и журналы. Деактивация никогда не удаляет данные. По умолчанию: выключено.

Оформление заказа

Покупатель выбирает способ оплаты (по умолчанию DPO Pay) и оформляет заказ. Плагин создаёт транзакцию DPO на сумму заказа в валюте заказа, с номером заказа и названием вашего сайта в качестве описания, и отправляет покупателя на страницу оплаты DPO. Имя, e-mail, телефон и адрес покупателя передаются для предзаполнения страницы. Там покупатель платит любым способом, включённым в вашей учётной записи DPO. Ссылка на оплату действительна 5 часов.

После оплаты покупатель возвращается в ваш магазин. Заказ отмечается оплаченным только после подтверждения DPO: плагин запрашивает у DPO результат транзакции при возвращении покупателя, при получении push-уведомления и при автоматических повторных проверках. Когда платёж подтверждён, покупатель переходит на страницу получения заказа.

Если платёж не подтверждён, покупатель возвращается на оформление заказа или на страницу Pay for order с одним из этих сообщений:

Если покупатель нажимает на странице DPO кнопку возврата в магазин, заказ отменяется стандартным для WooCommerce способом, а его ссылка на оплату DPO отменяется в DPO.

Когда покупатель платит повторно за тот же заказ, сначала проверяется предыдущая ссылка на оплату DPO. Если она была оплачена, заказ завершается без повторного списания. Если она ещё обрабатывается, покупатель видит Your previous payment for this order is still being processed by DPO. Please wait a few minutes before trying again. В противном случае старая ссылка отменяется в DPO и создаётся новая.

Если DPO не может начать платёж, покупатель видит короткое сообщение, выбранное по коду ошибки DPO, например о том, что DPO Pay не поддерживает валюту этого заказа, или что сумма превышает лимит, разрешённый DPO Pay, и может выбрать другой способ оплаты.

Способ оплаты работает на классическом оформлении заказа, в блоке «Оформление заказа» и на странице Pay for order. Он совместим с WooCommerce High-Performance Order Storage (HPOS).

Плагин принимает только разовые платежи на странице DPO. В нём нет возвратов из WooCommerce, сохранённых карт, подписок или регулярных платежей, полей карты на вашем сайте и списания по платежам, которые только авторизованы.

Заказы

Статусы заказа

Pending payment: покупатель был отправлен в DPO и ещё не заплатил, либо DPO ещё не подтвердил платёж.

Processing, Completed или On hold: платёж проверен. Статус соответствует Successful payment status. В примечании к заказу показаны сумма, валюта, код подтверждения и начало токена транзакции DPO. Идентификатор транзакции — это токен транзакции DPO.

On hold after payment: DPO подтвердил платёж, но сумма или валюта отличаются от заказа, платёж только авторизован и не списан, транзакция была с переплатой или недоплатой, либо заказ уже был отменён. Примечание к заказу объясняет причину. Проверьте транзакцию в портале DPO. Выполните списание или отмену платежа, который только авторизован, в портале DPO, затем обновите заказ.

Failed: платёж был отклонён, отменён, либо истёк срок оплаты. Покупатель может заплатить снова.

Cancelled: покупатель вернулся в магазин со страницы DPO, либо заказ был отменён вами или по тайм-ауту WooCommerce для неоплаченных заказов. Неоплаченная ссылка на оплату DPO отменяется в DPO.

Более позднее сообщение об отказе никогда не меняет уже оплаченный заказ, а результаты старых ссылок на оплату никогда не приводят к сбою текущей попытки. Если DPO подтверждает второй успешный платёж по заказу, который уже оплачен, заказ получает примечание о возможной повторной оплате, чтобы вы могли вернуть деньги в портале DPO.

Возвраты

Возвраты из WooCommerce недоступны в этой версии. Верните платёж в портале мерчанта DPO, затем отметьте заказ как возвращённый в WooCommerce.

Лицензионный ключ

Плагин работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии находится в верхней части WooCommerce > Settings > Payments > DPO Pay. Вставьте ключ в License key и нажмите Activate. Блок показывает статус, например дату, до которой активна лицензия, и ваш домен. Используйте Check now, чтобы проверить статус снова, Change key, чтобы ввести другой ключ, и Remove key, чтобы удалить его с этого сайта. Ссылка Manage licenses and domains in your account открывает ваш аккаунт на vibefox.net.

Один ключ работает на одном домене. Удаление ключа с сайта не освобождает слот его домена. Освободите слот в своём аккаунте на vibefox.net.

Без активного ключа DPO Pay не показывается покупателям при оформлении заказа. Если платёж всё же запущен, покупатель видит This payment method is not available. Please choose another one. Вошедшие менеджеры магазина всё равно видят способ оплаты, помеченный (unlicensed — visible to admins only), чтобы вы могли настроить и протестировать плагин до покупки ключа. Напоминание появляется на странице плагинов и на страницах WooCommerce. Существующие заказы не затрагиваются: уже начатые платежи всё равно подтверждаются.

Когда лицензия истекает, плагин продолжает работать, но обновления и поддержка требуют продления. Статус автоматически проверяется снова в фоновом режиме.

Устранение неполадок

DPO Pay не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включён, а Company Token и Service Type выбранного режима заполнены: тестовые поля — в тестовом режиме, рабочие — в остальных случаях. Страница настроек показывает предупреждение, когда они отсутствуют.

Платёж прошёл, но заказ остаётся Pending payment: вероятно, URL push-уведомления не настроен для вашей учётной записи DPO, и покупатель не вернулся в магазин. Попросите поддержку DPO настроить URL, показанный в настройках. Заказ также подтверждается автоматической повторной проверкой через 15 минут после перенаправления. Включите Logging и посмотрите WooCommerce > Status > Logs, источник wcp_dpo_pay.

Push-уведомление отвечает Unknown transaction: токен транзакции не относится к заказу DPO Pay этого магазина, например уведомление пришло от другого магазина на той же учётной записи DPO.

Push-уведомление отвечает Verification failed: не удалось связаться с DPO для проверки платежа. DPO повторяет уведомление, а автоматическая повторная проверка также подтверждает заказ.

Service Type не сохраняется: он должен быть числовым Service Type ID из DPO.

Покупатель видит DPO Pay is temporarily unavailable: DPO отказался создать транзакцию, например из-за неверного Company Token или Service Type, либо токена другого режима. Код результата DPO указан в WooCommerce > Status > Logs, источник wcp_dpo_pay.

Покупатель видит, что DPO принимает не более 2 десятичных знаков: сумма заказа содержит 3 десятичных знака. DPO не может списывать такие суммы.

Заказ в статусе On hold после оплаты: прочитайте примечание к заказу. Оплаченная сумма или валюта отличались от заказа, платёж только авторизован, транзакция была с переплатой или недоплатой, либо заказ был отменён. Проверьте транзакцию в портале DPO.

Блок лицензии показывает ошибку: следуйте сообщению в блоке. Например, если ключ уже используется на другом домене, освободите слот в своём аккаунте на vibefox.net и нажмите Check now. Если адрес сайта изменился, нажмите Check now, чтобы активировать ключ для нового домена. Если сервер лицензий недоступен, плагин продолжает работать с последним известным статусом.

Удаление

Деактивация плагина сохраняет все данные и только останавливает запланированные проверки статуса. Чтобы удалить его, деактивируйте и удалите его на странице Plugins. Лицензионный ключ и статус лицензии этого плагина удаляются всегда. Настройки, данные DPO, сохранённые в заказах, запланированные проверки и журналы удаляются только если была включена Delete data. Иначе они остаются для последующей переустановки. Существующие заказы сохраняют свои примечания об оплате и идентификаторы транзакций.

DPO Pay — товарный знак своего владельца. Этот плагин не связан с DPO Pay и не одобрен DPO Pay.