VibeFox Stripe for WooCommerce — Помощь

Требования

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

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

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

HTTPS: для реальных платежей ваш сайт должен работать по HTTPS.

Учётная запись Stripe: нужны секретные API-ключи вашей учётной записи Stripe и endpoint вебхука в Stripe Dashboard (см. Настройка). Используются только секретные ключи и секреты подписи вебхуков. Публикуемые ключи (pk_...) не нужны, потому что Stripe Checkout — страница, которую размещает Stripe.

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

Установка

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

2. Нажмите Activate.

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

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

5. Вставьте секретные ключи Stripe, настройте вебхук в Stripe Dashboard и вставьте его секреты подписи (см. Настройка).

6. Включите Enable/Disable. Проверьте оплату в тестовом режиме картой 4242 4242 4242 4242, затем снимите отметку с Test Mode.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Stripe. Над полями страница предупреждает, если в текущем режиме нет секретного ключа (тогда способ оплаты скрывается при оформлении заказа) или секрета подписи вебхука, и показывает Test mode is on: no real payments are taken., пока включён тестовый режим. В списке способов оплаты Stripe отмечен как требующий настройки, пока в текущем режиме нет секретного ключа.

Общее

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

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

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay securely with your credit or debit card via Stripe.

API-ключи

Скопируйте секретные ключи из Stripe Dashboard > Developers > API keys. Тестовые и рабочие ключи раздельные. Тестовый режим использует только тестовые ключи, рабочий режим — только рабочие. При сохранении плагин предупреждает, если значение не начинается с ожидаемого префикса, например когда вместо секретного ключа вставлен публикуемый.

Test Mode: Enable test mode использует тестовые ключи Stripe. Реальные деньги не списываются; платите тестовыми картами Stripe, например 4242 4242 4242 4242. По умолчанию: включено. Снимите отметку, чтобы принимать реальные платежи.

Test Secret Key: секретный ключ тестового режима. Начинается с sk_test_ (или rk_test_ для ограниченного ключа).

Test Webhook Secret: секрет подписи (whsec_...) endpoint вебхука, созданного в тестовом режиме.

Live Secret Key: секретный ключ рабочего режима. Начинается с sk_live_ (или rk_live_ для ограниченного ключа).

Live Webhook Secret: секрет подписи (whsec_...) endpoint вебхука, созданного в рабочем режиме.

Вебхук

Вебхук сообщает вашему магазину, что оплата произведена. В Stripe Dashboard > Developers > Webhooks добавьте endpoint в тестовом режиме и ещё один в рабочем. Используйте URL, который показан в этом разделе настроек. Он выглядит так: https://your-site/wc-api/strg_stripe_webhook/. Если на вашем сайте в URL используется префикс языка, скопируйте URL точно так, как его показывают настройки, потому что Stripe не переходит по редиректам.

Выберите эти события для каждого endpoint:

После создания каждого endpoint скопируйте его секрет подписи (whsec_...) из Stripe и вставьте в Test Webhook Secret или Live Webhook Secret. Вебхуки без правильной подписи отклоняются. Без вебхука заказ подтверждается только тогда, когда покупатель возвращается в магазин после оплаты.

Заказы

Order Status After Payment: статус заказа, который устанавливается после успешной оплаты. Статус устанавливается сразу, без второго изменения статуса.

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

Logging: Enable logging записывает запросы и вебхуки Stripe в WooCommerce > Status > Logs, источник wcp_stripe_gateway. Ключи и данные покупателей не записываются. По умолчанию: выключено.

Delete Data on Uninstall: если включено, при удалении плагина удаляются настройки шлюза, данные Stripe, сохранённые в заказах, и журналы. По умолчанию: выключено.

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

Покупатель выбирает способ оплаты (по умолчанию Stripe) и оформляет заказ. Плагин создаёт сессию Stripe Checkout на сумму заказа в валюте заказа и отправляет покупателя на страницу оплаты Stripe. Там покупатель платит кредитной или дебетовой картой. E-mail покупателя для выставления счёта передаётся в Stripe, и на странице Stripe платёж отображается как Order # и номер заказа.

После оплаты покупатель возвращается на страницу «Заказ получен» вашего магазина. Заказ отмечается оплаченным только после подтверждения Stripe: по подписанному вебхуку или по серверному запросу к Stripe, когда покупатель попадает на эту страницу. Если оплата ещё не подтверждена, страница показывает Your payment is being confirmed by Stripe. You will receive an e-mail as soon as it is confirmed.

Если покупатель отменяет оплату на странице Stripe, заказ отменяется стандартным для WooCommerce способом. Покупатель может повторно оплатить неоплаченный заказ, например со страницы Pay for order. Каждая новая попытка закрывает предыдущую сессию Stripe, поэтому заказ нельзя оплатить дважды.

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

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

Плагин принимает только платежи картами, которые списываются сразу на странице Stripe. В нём нет сохранённых карт, подписок и регулярных платежей, формы карты на вашем сайте, кнопок Apple Pay и Google Pay на вашем сайте и раздельной авторизации и списания.

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

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

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

Processing, Completed or On Hold: платёж подтверждён. Статус соответствует настройке Order Status After Payment. В примечании к заказу указаны платёж Stripe и способ подтверждения (вебхук или возврат покупателя). ID транзакции — это ID платежа Stripe (pi_...); на экране заказа он ведёт к платежу в Stripe Dashboard.

On hold after payment: Stripe сообщил сумму или валюту, отличающиеся от суммы заказа (например, заказ был изменён после начала оплаты), либо платёж поступил после отмены заказа. Примечание к заказу это объясняет. Проверьте заказ и выполните его или сделайте возврат платежа.

Failed: отложенный платёж не прошёл.

Cancelled: покупатель отменил оплату на странице Stripe, или заказ отменили вы либо истёк таймаут резервирования товара в WooCommerce. Открытая сессия Stripe заказа закрывается, поэтому его больше нельзя оплатить.

Если для уже оплаченного заказа поступает второй платёж, заказ больше не меняется. Примечание просит вас проверить его и вернуть дубликат в Stripe Dashboard.

Возвраты

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

Возвраты, сделанные в Stripe Dashboard, приходят через вебхук charge.refunded и добавляются в примечания к заказу. Они не регистрируются автоматически как возвраты WooCommerce. При необходимости создайте ручной возврат в WooCommerce, не используя Refund via Stripe.

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

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

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

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

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

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

Stripe не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено и в текущем режиме есть секретный ключ: Test Secret Key в тестовом режиме, Live Secret Key в рабочем режиме. На странице настроек появляется предупреждение, если ключ отсутствует.

Оплата прошла, но заказ остаётся Pending payment: вебхук не работает. В Stripe Dashboard проверьте, что endpoint существует в используемом режиме (тестовом или рабочем), что его URL точно совпадает с показанным в настройках и что выбраны все четыре события. Проверьте, что секрет подписи этого endpoint находится в нужном поле (Test Webhook Secret или Live Webhook Secret). Stripe Dashboard показывает ответ вашего магазина для каждого вебхука. Заказ также подтверждается, когда покупатель возвращается в магазин после оплаты.

Вебхук отвечает Webhook secret not configured: ни один из секретов вебхука не задан. Вставьте секрет подписи в настройки.

Вебхук отвечает Invalid signature: секрет подписи принадлежит другому endpoint или другому режиму, либо неверно время на сервере. Подписи Stripe принимаются в пределах 5 минут от времени сервера.

Вебхук отвечает Busy, retry: заказ в этот момент подтверждался другим запросом. Stripe повторяет вебхук автоматически.

Предупреждение при сохранении: значение выглядит неверным: ключ вставлен не в то поле. Секретные ключи начинаются с sk_test_ / rk_test_ или sk_live_ / rk_live_, секреты вебхуков — с whsec_.

Покупатель видит ошибку при оформлении заказа: откройте примечания к заказу или включите Logging и посмотрите WooCommerce > Status > Logs, источник wcp_stripe_gateway. Неверный или отсутствующий ключ даёт сообщение, что способ оплаты настроен неверно. Сумму заказа ниже минимума Stripe для валюты (например, 0,50 EUR) оплатить через Stripe нельзя.

Тестовые платежи не подтверждают рабочий заказ: тестовые и рабочие платежи разделены. Тестовый платёж никогда не подтверждает рабочий заказ, и наоборот. Переключите Test Mode на нужный режим и используйте ключи и вебхук этого режима.

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

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

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

Удаление

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

Stripe является товарным знаком его правообладателя. Этот плагин не связан с компанией Stripe и не одобрен ею.