VibeFox Flow for WooCommerce — Помощь

Требования

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

WooCommerce: 8.0 или новее, установлен и активен.

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

Валюта магазина: чилийский песо (CLP) или доллар США (USD). Для других валют способ оплаты скрывается при оформлении заказа. В магазинах с CLP установите WooCommerce > Settings > General > Number of decimals в 0, поскольку Flow списывает целые песо.

Учётная запись Flow: нужны API Key и Secret Key вашей учётной записи Flow из раздела Mis datos, Datos técnicos в Flow. Для проверок создайте отдельную тестовую учётную запись на sandbox.flow.cl и используйте её ключи. Ключи тестовой и рабочей среды различаются. В учётной записи Flow ничего настраивать не нужно.

Общедоступный сайт: URL подтверждения, возврата покупателя и возврата средств вашего магазина должны быть доступны из интернета, без режима обслуживания, защиты паролем или блокирующего Flow межсетевого экрана.

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите API Key и Secret Key тестовой среды, включите Enable / Disable, сохраните и оформите тестовый заказ.

6. Для приёма реальных платежей заполните рабочие ключи и снимите флажок Sandbox mode.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Flow.cl. Над полями страница предупреждает, если ключи текущего режима не заполнены (тогда Flow скрывается при оформлении заказа), валюта магазина не поддерживается или магазин с CLP использует десятичные знаки (Flow списывает целые песо, поэтому установите Number of decimals в 0, чтобы цены, итоги и возвраты точно совпадали). В тестовом режиме отображается Sandbox mode — платежи идут на sandbox.flow.cl, реальные деньги не списываются. В списке способов оплаты Flow помечается как требующий настройки, пока не заданы ключи текущего режима, а в тестовом режиме показывает соответствующий значок.

Общие настройки

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

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

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.

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

Скопируйте API Key и Secret Key из учётной записи Flow (Mis datos, Datos técnicos): рабочие ключи на www.flow.cl, тестовые ключи на sandbox.flow.cl (отдельная тестовая учётная запись).

Sandbox mode: Use the Flow sandbox (sandbox.flow.cl) and the sandbox keys. В тестовом режиме реальные деньги не списываются. По умолчанию: включено. Отключите его и заполните рабочие ключи для приёма реальных платежей. Возвраты всегда выполняются в той среде, где был оплачен заказ.

Sandbox API Key: API Key вашей учётной записи sandbox.flow.cl.

Sandbox Secret Key: Secret Key вашей учётной записи sandbox.flow.cl. Используется для подписи каждого запроса.

Live API Key: API Key вашей учётной записи www.flow.cl.

Live Secret Key: Secret Key вашей учётной записи www.flow.cl. Храните его в тайне.

Уведомления

Плагин передаёт Flow три URL с каждым платежом и возвратом, поэтому в учётной записи Flow ничего настраивать не нужно. Они перечислены в этом разделе:

Подтверждение содержит только платёжный токен. Затем плагин запрашивает у Flow статус платежа подписанным запросом в среде, где был создан платёж, и применяет только ответ Flow. Платёж, который этот магазин не создавал для данного заказа, отклоняется. Без подтверждения заказ обновляется при возвращении покупателя из Flow.

Расширенные настройки

Debug log: Log API calls and notifications в WooCommerce > Status > Logs, источник wcp_flow_gateway, без ключей и данных покупателей. Ошибки записываются всегда. По умолчанию: выключено.

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Flow data saved on orders is kept). По умолчанию: выключено.

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

Покупатель выбирает способ оплаты (по умолчанию Flow) и оформляет заказ. В тестовом режиме при оформлении отображается SANDBOX MODE — платежи идут в тестовую среду Flow. Реальных списаний нет. Требуется действительный платёжный адрес электронной почты. Плагин создаёт платёж Flow на полную сумму заказа в его валюте с темой Order #, дополненной номером заказа и названием сайта, и направляет покупателя на платёжную страницу Flow. Там покупатель выбирает способ оплаты, включённый в вашей учётной записи Flow.

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

Если платёж отклонён, покупатель возвращается на страницу Pay for order (или оформления заказа) с сообщением Your Flow payment was rejected. Please try again or choose another payment method. Если покупатель покинул страницу Flow без оплаты, сообщение — The Flow payment was not completed. You can try again or choose another payment method. Если результат не удалось проверить, сообщение — We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly; otherwise please try again. Каждая новая попытка создаёт новый платёж Flow, привязанный к заказу.

Если Flow не может начать оплату, покупатель видит краткое сообщение, например Could not connect to Flow. Please try again in a moment. Подробности находятся в журнале.

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

Плагин принимает только разовые платежи. В нём нет сохранённых карт, подписок, регулярных списаний и платёжных ссылок; он не выбирает заранее способ оплаты Flow. Flow не может отменить уже созданную платёжную ссылку: если покупатель оплатит старую ссылку после оплаты более новой, в заказ добавится заметка с просьбой вернуть повторный платёж через Flow.

Заказы и возвраты

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

Pending payment: покупатель направлен в Flow и ещё не оплатил заказ. Заметка к заказу показывает сумму и номер заказа Flow для этой попытки.

On hold, awaiting coupon payment: покупатель создал платёжный купон Servipag или Multicaja. Заказ изменяется, когда Flow подтверждает оплату.

Processing: Flow сообщил об оплате, сумма и валюта совпадают (заказы только с виртуальными загружаемыми товарами переходят в статус «Выполнен» — стандартное поведение WooCommerce). Заметка к заказу показывает сумму и номер заказа Flow. Идентификатор транзакции заказа — номер заказа Flow.

On hold, amount/currency mismatch: Flow сообщил сумму или валюту, отличающуюся от заказа. Заказ не отмечен оплаченным; проверьте его вручную.

On hold, payment for a cancelled order: поступил платёж за заказ, который был отменён без оплаты. Проверьте заказ и отправьте его либо верните платёж через Flow.

Failed: Flow отклонил последнюю попытку оплаты неоплаченного заказа. Покупатель может попробовать снова.

Cancelled: последняя попытка оплаты аннулирована в Flow.

Если поступает ещё один платёж за уже оплаченный заказ, заказ не меняется. Заметка просит вернуть повторный платёж в вашей учётной записи Flow. Оплаченный, а затем отменённый или возвращённый заказ никогда не открывается заново.

Возвраты

Откройте заказ, нажмите Refund, введите сумму и нажмите Refund via Flow. Поддерживаются полные и частичные возвраты. Возврат отправляется в среду, где был оплачен заказ (тестовую или рабочую), поэтому должны быть заданы её ключи, а в заказе необходим платёжный адрес электронной почты. Flow отправляет покупателю письмо для завершения возврата. Если Flow отказывает в возврате, WooCommerce показывает ошибку и возврат не регистрируется. Успешный запрос добавляется в заметки к заказу с номером и статусом возврата Flow.

Последующие изменения статуса возврата, сообщённые Flow, добавляются в заметки к заказу. Если Flow позже отклонит или отменит возврат, заметка сообщит, что деньги покупателю не возвращены; запись возврата WooCommerce сохраняется, поэтому обработайте ситуацию вручную. Возвраты, созданные в панели Flow, не импортируются в WooCommerce.

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

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

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

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

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

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

Flow не отображается при оформлении заказа: проверьте, что лицензия активна, Enable / Disable включено, ключи текущего режима заполнены (тестовые в тестовом режиме, рабочие в рабочем) и валюта магазина — CLP или USD. На странице Pay for order проверяется валюта заказа.

Платёж прошёл, но заказ остаётся в статусе Pending payment: подтверждение Flow не доходит до магазина, а покупатель не вернулся. Проверьте, что указанный в настройках URL подтверждения доступен из интернета и не заблокирован режимом обслуживания, паролем или межсетевым экраном. Включите Debug log и посмотрите WooCommerce > Status > Logs, источник wcp_flow_gateway.

Подтверждение отвечает Payment does not belong to the order или Unknown order: платёж не создан этим магазином для этого заказа либо создан в другой среде. Заказ не меняется.

Подтверждение отвечает Gateway not configured: ключи среды платежа не заполнены. Введите их заново.

Подтверждение отвечает Flow API unavailable: запрос статуса в Flow не удался. Flow повторяет подтверждение.

Покупатель видит Flow payments are not available at the moment: ключи отсутствуют или Flow отклонил их. Проверьте API Key и Secret Key текущего режима.

Покупатель видит A valid billing email is required for Flow payments: Flow нужен адрес электронной почты покупателя.

Покупатель заплатил, но заказ в статусе On hold: прочитайте заметку к заказу. Покупатель создал ещё не оплаченный купон для оплаты наличными либо сумма или валюта от Flow не совпадают с заказом. Итоги в CLP с десятичными знаками округляются до целых песо, поэтому установите Number of decimals в 0.

Возврат не проходит с сообщением о тестовых или рабочих ключах: заказ оплачен в этой среде, а её ключи не заполнены. Введите их и повторите попытку.

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

Для разработчиков в readme указан фильтр wc_flw_supported_currencies (валюты, для которых предлагается шлюз).

Удаление

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

Flow является товарным знаком соответствующего владельца. Этот плагин не связан с Flow и не одобрен Flow.