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

Вимоги

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

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

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

Обліковий запис мерчанта Redsys: ваш банк (еквайр, який надав вам віртуальний POS-термінал Redsys) надає код мерчанта (FUC), номер терміналу та доступ до панелі адміністрування Redsys, де показано секретний ключ SHA-256 кожного середовища. Ключ тестового середовища відрізняється від робочого. Онлайн-сповіщення (HTTP) має бути увімкнене для вашого терміналу. Якщо ви не впевнені, запитайте у банку.

Валюта магазину: одна з валют, які підтримує плагін (див. розділ «Конфігурація»), і банк має увімкнути для неї ваш термінал Redsys. Більшість терміналів приймають лише EUR.

Доступний сайт: Redsys має мати змогу звертатися до вашого сайту з інтернету без входу та блокування брандмауером, щоб доставляти сповіщення про платежі.

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

Встановлення

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

2. Натисніть Activate.

3. Відкрийте налаштування: WooCommerce > Settings > Payments > Redsys > Manage або натисніть Settings під назвою плагіна на сторінці Plugins.

4. Введіть ліцензійний ключ VibeFox у блоці ліцензії вгорі сторінки та натисніть Activate.

5. Введіть код мерчанта, термінал і секретний ключ кожного середовища (див. розділ «Конфігурація»).

6. Увімкніть Enable/Disable. Перевірте платіж з увімкненим Test Mode, потім знімте позначку з Test Mode, щоб приймати реальні платежі.

Конфігурація

Усі налаштування розташовані на одній сторінці: WooCommerce > Settings > Payments > Redsys. Над полями сторінка попереджає, якщо код мерчанта не вказано або він складається не лише з цифр, якщо секретний ключ не є дійсним ключем Redsys SHA-256, якщо ключ поточного режиму порожній (тоді спосіб оплати приховується під час оформлення замовлення) і якщо валюта магазину не підтримується. Поки тестовий режим увімкнено, сторінка показує Test mode is active: payments go to the Redsys test environment (SIS-T), no real money is charged. Після збереження попередження одразу відображають нові налаштування. У списку способів оплати Redsys позначено як такий, що потребує налаштування, доки код мерчанта, термінал і ключ поточного режиму не будуть дійсними.

Загальні

Enable/Disable: Enable Redsys Gateway вмикає або вимикає спосіб оплати. За замовчуванням: вимкнено.

Title: назва способу оплати, яку бачать покупці під час оформлення замовлення. За замовчуванням: Credit/Debit Card (Redsys).

Description: текст під способом оплати під час оформлення замовлення. За замовчуванням: Pay securely with your credit or debit card via Redsys.

Обліковий запис Redsys

Ваш банк надає код мерчанта, термінал і доступ до панелі адміністрування Redsys, де показано секретний ключ SHA-256 кожного середовища. Розділ містить посилання на панель адміністрування Redsys.

Merchant Code (FUC): ваш код мерчанта Redsys, до 9 цифр. Будь-які символи, що не є цифрами, видаляються під час збереження.

Terminal Number: номер терміналу, призначений вашим банком, до 3 цифр. За замовчуванням: 1. Порожнє поле зберігається як 1.

Secret Key (SHA-256) — live: ключ SHA-256 у форматі Base64 для робочого (продуктивного) середовища. Він використовується, коли тестовий режим вимкнено.

Тестовий режим (SIS-T)

Тестове середовище Redsys має власний секретний ключ. Розділ показує публічні тестові дані Redsys: код мерчанта 999008881, термінал 1, ключ sq7HjrUOBfKmC576ILgskD5srU870gJ7, картка 4548 8100 0000 0003, термін дії 12/49, CVV 123. У тестовому режимі реальні кошти не списуються.

Test Mode: Enable test mode надсилає платежі та повернення до тестового середовища Redsys (SIS-T) і підписує їх тестовим ключем. За замовчуванням: увімкнено. Зніміть позначку, щоб приймати реальні платежі. Поки режим увімкнено, під способом оплати під час оформлення замовлення показується TEST MODE: Redsys test environment, no real money is charged.

Secret Key (SHA-256) — test: ключ SHA-256 у форматі Base64 тестового середовища. Використовуйте власний тестовий ключ або публічний тестовий ключ, наведений вище.

Сторінка оплати та замовлення

Commerce Name: назва магазину на платіжній сторінці Redsys, не більше 25 символів. За замовчуванням: назва вашого сайту, обрізана до 25 символів.

Order Status After Payment: статус замовлення після успішної оплати. Статус встановлюється один раз, тож покупець отримує один лист.

Сповіщення про платежі

Redsys повідомляє про кожен платіж на адресу сповіщень вашого магазину. Вона має вигляд https://your-site/wc-api/rdsg_redsys/ і показується в цьому розділі. Плагін надсилає її до Redsys з кожним платежем, тож у панель Redsys нічого копіювати не потрібно. Онлайн-сповіщення (HTTP) має бути увімкнене для вашого терміналу. Запитайте у банку, якщо замовлення після успішної оплати лишаються в статусі «Очікує оплати». Сповіщення без дійсного підпису відхиляються. Без сповіщення замовлення не позначається оплаченим.

Додатково

Debug log: Enable debug logging записує деталі платежів, сповіщень і повернень до WooCommerce > Status > Logs, джерело wcp_redsys_gateway. Помилки записуються завжди, навіть коли ця опція вимкнена. Ключі, підписи та дані карток ніколи не записуються. За замовчуванням: вимкнено.

Delete Data: Delete the gateway settings when the plugin is deleted. Якщо увімкнено, видалення плагіна стирає налаштування шлюзу та журнали плагіна. За замовчуванням: вимкнено.

Підтримувані валюти

EUR, USD, GBP, JPY, CHF, CAD, AUD, NZD, NOK, SEK, DKK, PLN, CZK, HUF, BGN, RON, ILS, INR, MYR, SGD, THB, SAR, ZAR, RUB, BRL, MXN, ARS, CLP, COP, PEN, CNY, TWD. Спосіб оплати приховується для інших валют. На сторінці Pay for order враховується валюта замовлення.

Оформлення замовлення

Покупець обирає спосіб оплати (за замовчуванням Credit/Debit Card (Redsys)) і оформлює замовлення. Замовлення переходить у статус «Очікує оплати», а покупець бачить Redirecting to Redsys for payment. Please wait..., після чого переходить на сторінку оплати Redsys вашого банку. Якщо браузер не переходить самостійно, покупець натискає Pay via Redsys. На сторінці Redsys покупець сплачує карткою з 3-D Secure або через Bizum чи інший спосіб, увімкнений вашим банком для терміналу. Сторінка використовує мову вашого магазину (іспанська, англійська, каталонська, французька, німецька, італійська, португальська та інші) або англійську для інших мов.

Сума передається в мінімальних одиницях валюти замовлення, наприклад EUR 43,45 як 4345, а JPY або CLP — без десяткових знаків. Платіж описується як Order з номером замовлення та назвою вашого сайту. Залишок на складі зменшується, коли платіж підтверджено, а не раніше.

Після оплати покупець повертається на сторінку «Замовлення отримано» вашого магазину. Замовлення позначається оплаченим лише після того, як Redsys підтвердить платіж підписаним сповіщенням. Поки його немає, сторінка показує Redsys is confirming your payment. If you completed the payment, your order will be updated in a few moments — please do not pay again.

Якщо покупець скасовує оплату або платіж відхилено, Redsys повертає покупця до вашого магазину. Для замовлення, оформленого через кошик, замовлення скасовується стандартним для WooCommerce способом, а кошик зберігається. Для замовлення, створеного вами в адмінці (посилання на оплату), покупець повертається на сторінку Pay for order з повідомленням The Redsys payment was not completed. You can try again or choose another payment method., і замовлення не скасовується. Сторінка переспрямування вашого магазину також пропонує Cancel order & restore cart або, для замовлень, створених в адмінці, Choose another payment method.

Покупець може знову оплатити неоплачене замовлення на сторінці Pay for order. Кожна спроба отримує новий номер замовлення Redsys, і платіж, зроблений з будь-якої з них, наприклад із другої вкладки браузера, все одно розпізнається.

Якщо замовлення не вдалося надіслати до Redsys, покупець бачить коротке повідомлення і може обрати інший спосіб оплати: Redsys payments are not configured correctly. Please choose another payment method or contact us., повідомлення про те, що валюта не приймається, або The order total must be greater than zero.

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

Плагін приймає разові платежі, які одразу авторизуються та списуються на сторінці Redsys. На вашому сайті немає форми введення картки (InSite або iframe), немає збережених карток, оплати в один клік чи токенізації, підписок або періодичних платежів, попередньої авторизації з наступним списанням і SOAP-сповіщень.

Замовлення та повернення

Статуси замовлень

Pending payment: покупця перенаправлено до Redsys, і він ще не сплатив, або сповіщення Redsys ще не надійшло. Примітка до замовлення: Awaiting Redsys payment.

Processing, Completed or On Hold: платіж підтверджено. Статус відповідає Order Status After Payment. У примітці до замовлення вказано номер замовлення Redsys (Ds_Order), код авторизації та код відповіді; для тестових платежів позначено [TEST]. ID транзакції замовлення — це номер замовлення Redsys.

On hold after payment: Redsys повідомив суму або валюту, що відрізняються від суми замовлення, тестовий платіж надійшов, поки магазин працює в робочому режимі (реальні кошти не списувалися), або платіж надійшов після скасування замовлення. Примітка до замовлення пояснює причину. Перевірте платіж в панелі адміністрування Redsys, потім відправте замовлення або поверніть платіж.

Failed: платіж було відхилено або скасовано в Redsys. У примітці до замовлення вказано код відповіді та, для поширених кодів, коротку причину, наприклад Insufficient funds, Card expired або Cancelled by the customer. Лише замовлення, яке ще очікує оплати, переходить у статус «Невдалий». Оплачене або закрите замовлення ніколи не змінюється через відхилену спробу: спроба лише позначається приміткою.

Cancelled: покупець скасував платіж, або замовлення скасували ви чи тайм-аут резервування залишків WooCommerce.

Якщо для вже оплаченого або повернутого замовлення надходить другий, інший платіж, замовлення не змінюється. Примітка пропонує повернути дублікат платежу в панелі адміністрування Redsys. Якщо Redsys повідомляє, що платіж ще виконується, додається примітка, і замовлення чекає остаточного результату.

Повернення коштів

Відкрийте замовлення, натисніть Refund, введіть суму та натисніть кнопку повернення через спосіб оплати Redsys (за замовчуванням Refund via Credit/Debit Card (Redsys)). Підтримуються повні та часткові повернення. Повернення надсилається через REST API Redsys до того середовища, де було здійснено платіж (тестового або робочого), підписується ключем цього середовища, і перевіряється підпис відповіді. Якщо Redsys не приймає повернення, WooCommerce показує помилку і повернення не реєструється. Успішне повернення додається до приміток замовлення з номером замовлення Redsys і причиною.

Повернення, зроблені в панелі адміністрування Redsys, не реєструються як повернення WooCommerce. Коли Redsys надсилає про них сповіщення, до замовлення додається примітка. За потреби створіть ручне повернення в WooCommerce без кнопки повернення Redsys.

Ліцензійний ключ

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

Один ключ працює на одному домені. Видалення ключа з сайту не звільняє місце для домену. Звільніть його у своєму обліковому записі vibefox.net.

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

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

Усунення несправностей

Redsys не відображається під час оформлення замовлення: перевірте, що ліцензія активна, увімкнено Enable/Disable, заповнено код мерчанта та термінал, а для поточного режиму є дійсний ключ: Secret Key (SHA-256) — test у тестовому режимі, Secret Key (SHA-256) — live у робочому. Перевірте, що валюта магазину (на сторінці Pay for order — валюта замовлення) є в списку підтримуваних валют. Сторінка налаштувань показує попередження для кожної з цих проблем.

Платіж пройшов, але замовлення лишається в статусі Pending payment: сповіщення Redsys не дійшло до вашого магазину. Попросіть банк перевірити, що онлайн-сповіщення (HTTP) увімкнене для вашого терміналу. Переконайтеся, що адреса, яка показана в розділі Сповіщення про платежі, доступна з інтернету без входу, сторінки обслуговування та блокування брандмауером. Увімкніть Debug log і перегляньте WooCommerce > Status > Logs, джерело wcp_redsys_gateway.

Сповіщення відповідає Forbidden: підпис не відповідав секретному ключу середовища, в якому було розпочато платіж, або код мерчанта в сповіщенні не ваш. Перевірте, що секретні ключі та код мерчанта в налаштуваннях відповідають вашому терміналу.

Сповіщення відповідає Order not found: сповіщення підписано правильно, але жодне замовлення цього магазину не використовує цей номер замовлення Redsys.

Сповіщення відповідає Busy: замовлення в цей самий момент оброблялося іншим сповіщенням. Redsys повторно надішле сповіщення.

Сповіщення відповідає Bad request: запит не містив параметрів Redsys або вони були пошкоджені. Він надійшов не від Redsys у очікуваному форматі.

Замовлення має статус On hold after payment: прочитайте примітку до замовлення. Сплачена сума або валюта відрізнялися від замовлення, тестовий платіж надійшов, поки магазин працює в робочому режимі, або платіж надійшов після скасування замовлення. Відправте замовлення або поверніть платіж.

Тестові платежі не підтверджують замовлення в робочому режимі: тестовий платіж ніколи не оплачує замовлення, поки Test Mode вимкнено. Замість цього замовлення переводиться на утримання з приміткою. Для тестових платежів використовуйте тестовий режим із тестовим ключем.

Повернення не проходить: прочитайте помилку. Redsys refund: the merchant code or the TEST secret key is not configured. (або LIVE) означає, що не вказано ключ середовища платежу. Коди помилок Redsys пояснено в повідомленні, наприклад SIS0057 (сума перевищує залишок платежу), SIS0056 (вихідний платіж не знайдено: інше середовище або термінал), SIS0042 (помилка підпису, перевірте ключ цього середовища), SIS0026 (невідомий код мерчанта або термінал) і SIS0027 (валюта не налаштована для терміналу). Якщо Redsys недоступний, повернення не виконується. Спробуйте пізніше.

Ваш термінал приймає валюту, якої немає в списку: розробники можуть змінити список валют фільтром rdsg_currency_codes. Додавайте валюту, лише якщо банк увімкнув її для терміналу.

Після оновлення з версії 1.0: ключ, який ви використовували в тестовому режимі, тепер знаходиться в Secret Key (SHA-256) — test. Введіть робочий ключ, перш ніж знімати позначку з Test Mode. Замовлення, створені у версії 1.0, і далі отримують сповіщення та повернення.

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

Видалення

Деактивація плагіна зберігає всі дані. Щоб видалити його, деактивуйте й видаліть плагін на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна завжди видаляються. Налаштування шлюзу та журнали плагіна видаляються лише тоді, коли була увімкнена опція Delete Data; інакше вони зберігаються для майбутнього повторного встановлення. Дані Redsys, збережені в замовленнях, завжди зберігаються, оскільки вони документують платежі та потрібні для повернень. Наявні замовлення зберігають свої примітки про оплату та ID транзакцій.

Redsys — торговельна марка її власника. Цей плагін не афілійований із Redsys і не схвалений нею.