VibeFox Stripe for WooCommerce — Допомога

Вимоги

WordPress: 6.0 або новіша версія.

WooCommerce: 7.0 або новіша, встановлений і активний. Плагін не активується без нього.

PHP: 8.0 або новіша версія.

HTTPS: для реальних платежів ваш сайт має використовувати HTTPS.

Обліковий запис Stripe: потрібні секретні API-ключі вашого облікового запису Stripe і кінцева точка вебхука в 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_...) кінцевої точки вебхука, створеної в тестовому режимі.

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

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

Вебхук

Вебхук повідомляє вашому магазину, що платіж здійснено. У Stripe Dashboard > Developers > Webhooks додайте кінцеву точку в тестовому режимі та ще одну в робочому. Використовуйте URL, який показано в цьому розділі налаштувань. Він має такий вигляд: https://your-site/wc-api/strg_stripe_webhook/. Якщо ваш сайт використовує префікс мови в URL, скопіюйте URL точно так, як його показують налаштування, оскільки Stripe не переходить за перенаправленнями.

Виберіть ці події для кожної кінцевої точки:

Після створення кожної кінцевої точки скопіюйте її секрет підпису (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. Там клієнт платить кредитною або дебетовою карткою. Електронна адреса клієнта для виставлення рахунку передається до 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 перевірте, що кінцева точка існує в режимі, яким ви користуєтесь (тестовому або робочому), що її URL точно збігається з показаним у налаштуваннях і що вибрано чотири події. Перевірте, що секрет підпису цієї кінцевої точки є в потрібному полі (Test Webhook Secret або Live Webhook Secret). Stripe Dashboard показує відповідь вашого магазину для кожного вебхука. Замовлення також підтверджується, коли клієнт повертається до магазину після оплати.

Вебхук відповідає Webhook secret not configured: жоден із секретів вебхука не задано. Вставте секрет підпису в налаштування.

Вебхук відповідає Invalid signature: секрет підпису належить іншій кінцевій точці або іншому режиму, або годинник сервера встановлено неправильно. Підписи 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 і не схвалений Stripe.