VibeFox Pin Payments for WooCommerce — Допомога

Вимоги

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

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

PHP: 8.0 або новіша.

HTTPS: ваша сторінка оформлення замовлення має використовувати HTTPS, як того вимагає прийом платежів картками (PCI DSS). Дані картки надсилаються з браузера покупця безпосередньо до Pin Payments через Pin.js і ніколи не потрапляють на ваш сервер, тож магазин підпадає під PCI SAQ A-EP.

Обліковий запис Pin Payments: обліковий запис мерчанта Pin Payments (для компаній в Австралії або Новій Зеландії; покупці можуть платити з будь-якої країни). Потрібні його публічний (publishable) і секретний (secret) ключі: робочі — для робочого режиму, а для тестування — для тестового середовища. Секрет вебхука не потрібен: плагін не використовує вебхуки.

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

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

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

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

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

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

5. У панелі Pin Payments відкрийте Account > API Keys і скопіюйте тестові ключі в Test publishable key та Test secret key. Залиште Test mode увімкненим, увімкніть Enable/Disable і збережіть.

6. Оформіть тестове замовлення тестовою карткою Pin Payments. Коли все працює, введіть робочі ключі, вимкніть Test mode і збережіть.

Налаштування

Усі параметри розташовані на одній сторінці: WooCommerce > Settings > Payments > Pin Payments. Над полями сторінка показує повідомлення, поки ввімкнено тестовий режим, помилку, поки публічний або секретний ключ поточного режиму порожній, і помилку, якщо Pin Payments не підтримує валюту магазину (зі списком підтримуваних валют). У двох останніх випадках шлюз приховано на сторінці оформлення замовлення. Після збереження повідомлення вже відображають новий режим і ключі. У списку способів оплати шлюз позначено як такий, що потребує налаштування, доки в поточному режимі не заповнено обидва ключі.

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

Title: назва способу оплати, яка показується на сторінці оформлення замовлення. За замовчуванням: Credit card (Pin Payments).

Description: опис способу оплати, який показується на сторінці оформлення замовлення. За замовчуванням: Pay with your credit card via Pin Payments.

API-ключі

Ваші ключі знаходяться в панелі Pin Payments, у розділі Account > API Keys. Тестові ключі працюють лише з тестовим API, робочі — лише з робочим API. Публічний ключ використовує Pin.js у браузері покупця. Секретний ключ ніколи не залишає ваш сервер.

Test mode: Enable test mode. Використовує тестове середовище Pin Payments (test-api.pinpayments.com) і тестові ключі. Реальні списання не виконуються, а покупці бачать у формі картки повідомлення ТЕСТОВИЙ РЕЖИМ — реальні списання не виконуватимуться. Коли режим вимкнено, використовуються робочий API (api.pinpayments.com) і робочі ключі. За замовчуванням: увімкнено.

Test publishable key: публічний ключ вашого тестового облікового запису Pin Payments.

Test secret key: секретний ключ вашого тестового облікового запису Pin Payments. Це поле пароля.

Live publishable key: публічний ключ вашого робочого облікового запису Pin Payments.

Live secret key: секретний ключ вашого робочого облікового запису Pin Payments. Це поле пароля.

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

Додатково

Debug log: Log Pin Payments API calls — записи зберігаються в WooCommerce > Status > Logs, джерело wcp_pinpayments_gateway. Помилки записуються завжди; увімкніть цю опцію, щоб записувати також кожен виклик API. Дані картки, API-ключі та персональні дані покупців ніколи не записуються. За замовчуванням: вимкнено.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. Деактивація плагіна нічого не видаляє. Платіжні дані, збережені в замовленнях, завжди зберігаються. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Credit card (Pin Payments) з піктограмами Visa, Mastercard та American Express) і заповнює на вашій сторінці оформлення замовлення поля Card number, Expiry (MM / YY), CVC та Name on card. Перед надсиланням форма картки перевіряє довжину номера картки, місяць і рік закінчення терміну дії, CVC з 3 або 4 цифр та ім'я.

Після оформлення замовлення Pin.js надсилає з браузера дані картки та платіжну адресу безпосередньо до Pin Payments і отримує одноразовий токен картки. До вашого сервера надсилається лише цей токен. Далі ваш сервер створює підтверджене списання на суму замовлення у валюті замовлення з описом <store name> - Order <number>. Pin Payments відповідає в тому самому запиті. Замовлення позначається оплаченим лише після того, як Pin Payments повідомить про успішне списання, і лише на точно відповідну суму та валюту замовлення. Потім покупець потрапляє на сторінку «Замовлення отримано».

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

Повідомлення, які може побачити покупець: Вашу картку відхилено. Скористайтеся іншою карткою або зверніться до банку.; На вашій картці недостатньо коштів. Скористайтеся іншою карткою.; Термін дії вашої картки минув. Скористайтеся іншою карткою.; Код безпеки картки (CVC) неправильний.; Цей тип картки не приймається. Скористайтеся Visa, Mastercard або American Express.; Оплату не виконано: з причиною від Pin Payments для відхилених даних; Термін дії даних вашої картки минув. Введіть їх знову та повторіть спробу., коли токен не можна використати; Захищену форму картки не вдалося завантажити. Перезавантажте сторінку або виберіть інший спосіб оплати., коли Pin.js не завантажується; Оплата картками тимчасово недоступна. Повторіть спробу пізніше або виберіть інший спосіб оплати., коли Pin Payments відхиляє секретний ключ; Ми не змогли підтвердити вашу оплату через Pin Payments. Перевірте електронну пошту та виписку по картці перед повторною спробою або зв'яжіться з нами., коли Pin Payments не відповідає. Технічні деталі записуються в примітки до замовлення та в журнал.

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

У плагіні немає процесу 3-D Secure. Якщо ваш обліковий запис Pin Payments вимагає 3-D Secure, списання залишається в очікуванні, а плагін позначає замовлення як невдале, тож під час цієї спроби кошти не списуються; покупець бачить Оплату карткою не вдалося завершити (потрібна додаткова перевірка). Спробуйте іншу картку або інший спосіб оплати. Немає режиму лише авторизації з подальшим списанням, збережених карток, WooCommerce Subscriptions, Apple Pay чи Google Pay і вебхуків.

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

Order statuses

Processing: Pin Payments повідомив про успішне підтверджене списання точно на суму та у валюті замовлення. Замовлення лише з віртуальними товарами для завантаження переходять у статус Виконано, як це прийнято в WooCommerce за замовчуванням. У примітці до замовлення вказано суму та токен списання (і TEST MODE для тестових платежів). ID транзакції — це токен списання Pin Payments.

Failed: картку відхилено, списання залишилося в очікуванні (3-D Secure), Pin Payments відхилив секретний ключ або запит. Кожна невдала спроба додає до замовлення примітку з кодом помилки та повідомленням Pin Payments, також коли замовлення вже мало статус Невдало через попередню спробу. Покупець може повторити спробу з тим самим замовленням.

Pending payment: Pin Payments не дав чіткої відповіді (тайм-аут, помилка сервера, нечитабельна відповідь). Замовлення не позначається як невдале, адже списання могло бути створено. Примітка радить знайти опис списання в панелі Pin Payments, перш ніж покупець заплатить знову або замовлення буде відправлено. Цей статус — Очікує оплати.

On hold: Pin Payments списав суму або валюту, відмінні від замовлення (примітка показує очікувану та списану суми), або списання авторизовано, але не підтверджено. Перевірте списання в панелі Pin Payments, перш ніж обробляти замовлення.

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

Відкрийте замовлення, натисніть Refund, введіть суму та натисніть Refund via Credit card (Pin Payments) (на кнопці відображається ваш Title). Підтримуються повні та часткові повернення. Повернення надсилається в середовище (тестове або робоче), у якому було оплачено замовлення, тож секретний ключ цього режиму має бути заповнений. Успішний запит додає до замовлення примітку із сумою, токеном повернення Pin Payments і його статусом. Pin Payments обробляє повернення асинхронно, тому статус зазвичай Pending. Якщо Pin Payments відхиляє повернення або не відповідає, WooCommerce показує помилку, і повернення не реєструється.

Повернення, зроблені в панелі Pin Payments, не синхронізуються з WooCommerce, тож оформлюйте їх у WooCommerce.

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

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

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

Без активного ключа Pin Payments не показується покупцям на сторінці оформлення замовлення. Якщо оплату все ж розпочато, покупець бачить Цей спосіб оплати недоступний. Оберіть інший. Авторизовані менеджери магазину все одно бачать спосіб оплати, позначений як (без ліцензії — видно лише адміністраторам), щоб ви могли налаштувати та протестувати плагін до купівлі ключа. Нагадування з'являється на сторінці Плагіни та на сторінках WooCommerce. Наявні замовлення не змінюються: повернення працюють далі.

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

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

Pin Payments не з'являється на сторінці оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, заповнені обидва ключі поточного режиму (Test publishable key і Test secret key у тестовому режимі, робочі ключі в решті випадків), і що валюта кошика — одна з 14 підтримуваних. На сторінці Pay for order враховується валюта замовлення. Сторінка налаштувань показує помилку для відсутніх ключів і непідтримуваної валюти.

На сторінці оформлення замовлення з'являється «Ми не змогли підтвердити вашу оплату»: Pin Payments не відповів вчасно. Замовлення залишається в статусі Очікує оплати з приміткою. Знайдіть у панелі Pin Payments списання з описом <store name> - Order <number>, перш ніж покупець заплатить знову або замовлення буде відправлено. Плагін сам такого списання не шукає, а нова спроба створює нове списання.

Покупці бачать «Оплата картками тимчасово недоступна»: Pin Payments відхилив секретний ключ. Примітка до замовлення радить перевірити ключі поточного режиму. Тестові ключі працюють лише в тестовому режимі, робочі — лише в робочому.

Замовлення не проходять із повідомленням «потрібна додаткова перевірка»: ваш обліковий запис Pin Payments вимагає 3-D Secure, який плагін не підтримує. Попросіть Pin Payments вимкнути обов'язковий 3-D Secure.

Замовлення в статусі «На утриманні» з приміткою «does not match»: Pin Payments повідомив про суму або валюту списання, відмінні від замовлення. Перевірте списання в панелі Pin Payments і вручну зробіть повернення або завершіть замовлення.

Захищену форму картки не вдалося завантажити: Pin.js із CDN Pin Payments не завантажився в браузері, наприклад через блокувальник скриптів або плагін кешування чи оптимізації, що змінює скрипти. Виключіть сторінку оформлення замовлення з таких оптимізацій.

Повернення не проходить: прочитайте повідомлення. Повідомлення про режим TEST або LIVE означає, що секретний ключ режиму, у якому оплачено замовлення, порожній. Pin Payments не підтвердив повернення означає, що відповіді не було; перевірте списання в панелі Pin Payments, перш ніж повторювати спробу.

Оплату не виконано з причиною від Pin Payments: Pin Payments відхилив дані списання, наприклад суму нижче мінімального списання для валюти. Покупець бачить причину, а в примітці до замовлення є код помилки.

Тестові платежі: тестовий режим використовує тестове середовище та тестові ключі. Скористайтеся тестовими картками з документації для розробників Pin Payments, наприклад 4200 0000 0000 0000 (успішно) або 4100 0000 0000 0001 (відхилено), із будь-яким майбутнім терміном дії та будь-яким CVC. Замовлення зберігають режим, у якому були оплачені, тож повернення надходять у правильне середовище після зміни режиму.

Де знайти помилки: помилки завжди записуються в WooCommerce > Status > Logs, джерело wcp_pinpayments_gateway. Увімкніть Debug log, щоб бачити кожен виклик API.

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

Для розробників: фільтр wc_ppg_supported_currencies змінює список валют, а wc_ppg_icon змінює значок у списку способів оплати WooCommerce.

Видалення

Деактивація плагіна зберігає всі дані. Щоб видалити його, деактивуйте та видаліть плагін на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна завжди видаляються. Налаштування шлюзу, параметри версії плагіна та його журнали (файли журналів, включно з ротованими, і записи журналу в базі даних) видаляються лише якщо було увімкнено Delete data on uninstall. Інакше вони зберігаються для повторного встановлення. Платіжні дані, збережені в замовленнях, наприклад токен списання Pin Payments, ніколи не видаляються. Наявні замовлення зберігають свої платіжні примітки та ID транзакцій.

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