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

Вимоги

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

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

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

HTTPS: Klarna вимагає HTTPS для реальних платежів.

Обліковий запис мерчанта Klarna: вам потрібні облікові дані API Klarna (ім'я користувача та пароль) вашого облікового запису мерчанта для одного регіону API, а також тестові облікові дані з тестового порталу Klarna (див. Налаштування). Кожен регіон API має власні облікові дані. На один магазин можна використовувати лише один обліковий запис мерчанта (один регіон API).

Валюта магазину: валюта Klarna вашого регіону: EUR, SEK, NOK, DKK, GBP, CHF, PLN, CZK, HUF або RON у Європі; USD, CAD або MXN у Північній Америці; AUD або NZD в Океанії.

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

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

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

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

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

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

5. Виберіть API region вашого облікового запису мерчанта Klarna.

6. Введіть тестові ім'я користувача та пароль з тестового порталу Klarna, залиште увімкненим Test mode, увімкніть Enable/Disable і зробіть тестове замовлення.

7. Введіть робочі ім'я користувача та пароль з Klarna Merchant Portal, вимкніть Test mode і виберіть, коли замовлення захоплюються (за замовчуванням: коли замовлення позначено як Виконано).

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

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

Загальні

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

Title: назва способу оплати, яку бачить покупець в оформленні замовлення. За замовчуванням: Klarna.

Description: текст, який бачить покупець над віджетом Klarna. За замовчуванням: Pay now, later or in instalments with Klarna.

Облікові дані API

Облікові дані API Klarna (ім'я користувача та пароль) створюються в Klarna Merchant Portal (portal.klarna.com) у розділі Settings > Klarna API credentials. Тестові облікові дані беруться з тестового порталу: playground.eu.portal.klarna.com для Європи, playground.us.portal.klarna.com для Північної Америки та Океанії.

Test mode: Use the Klarna playground (test credentials, no real payments). За замовчуванням: увімкнено. Поки тестовий режим увімкнено, оформлення замовлення показує TEST MODE: Klarna playground, no real payment is made. Замовлення зберігають середовище, в якому були створені: захоплення і повернення для тестових замовлень завжди використовують тестові облікові дані.

API region: регіон вашого облікового запису мерчанта Klarna. Покупці можуть платити через Klarna лише з країн цього регіону, у валюті своєї країни.

Europe: Австрія, Бельгія, Фінляндія, Франція, Німеччина, Греція, Ірландія, Італія, Нідерланди, Португалія, Словаччина та Іспанія (EUR), Швеція (SEK), Норвегія (NOK), Данія (DKK), Велика Британія (GBP), Швейцарія (CHF), Польща (PLN), Чехія (CZK), Угорщина (HUF), Румунія (RON). За замовчуванням.

North America (US, CA, MX): США (USD), Канада (CAD), Мексика (MXN).

Oceania (AU, NZ): Австралія (AUD), Нова Зеландія (NZD).

Live username (UID): ім'я користувача API робочого середовища, наприклад PK12345_abcdef012345.

Live password: пароль API робочого середовища (спільний секрет).

Test username (UID): ім'я користувача API тестового середовища.

Test password: пароль API тестового середовища (спільний секрет).

Управління замовленнями

Розміщене замовлення Klarna є авторизацією: покупця списують лише тоді, коли замовлення захоплено. Незахоплені авторизації спливають, зазвичай через 28 днів, тож виконуйте (відправляйте) замовлення вчасно або використовуйте автоматичне захоплення.

Capture: момент, коли покупця списують. Повернення можливі лише для захоплених сум. Якщо захоплення не вдалося, замовлення переходить на утримання з приміткою.

When the order is Completed (recommended): захоплення під час відправлення, коли ви позначаєте замовлення як Виконано (за замовчуванням). Захоплена сума — це сума замовлення мінус уже захоплене, і не більше за суму, що ще авторизована.

Immediately (auto capture): списує кошти з покупця одразу, для цифрових товарів або послуг.

Manually in the Klarna portal: плагін не захоплює кошти. Захопіть замовлення в Klarna Merchant Portal.

Cancellation: Cancel the Klarna order (release the authorization) when a not yet captured order is Cancelled. За замовчуванням: увімкнено.

Сповіщення

Klarna повідомляє результат перевірки на шахрайство (замовлення, розміщені як "pending") на URL сповіщень, який показано в цьому розділі. Він має такий вигляд: https://your-site/wc-api/wc_kl_payment/. URL автоматично надсилається з кожним замовленням, тож у Klarna нічого не потрібно налаштовувати. Вміст сповіщення ніколи не вважається довіреним: кожне сповіщення перевіряється через Klarna Order Management API, і замовлення Klarna має посилатися на це замовлення магазину. Плагін діє згідно з тим, що повідомляє Klarna:

ACCEPTED: Klarna прийняла покупку. Після перевірки суми та валюти замовлення позначається як оплачене.

REJECTED or STOPPED: покупка не пройшла перевірку на шахрайство. Замовлення стає Невдалим.

Klarna order CANCELLED, EXPIRED or CLOSED: покупця не було списано. Замовлення скасовується.

Якщо Klarna приймає покупку після того, як ви скасували або повернули замовлення, замовлення не відкривається знову, а авторизація Klarna знімається.

Додатково

Debug log: Log API calls and payment events у WooCommerce > Status > Logs, джерело wcp_klarna_payment. Помилки завжди записуються. Журнали ніколи не містять облікових даних чи даних покупців. За замовчуванням: вимкнено.

Uninstall: Delete the plugin settings and logs when the plugin is deleted. Дані замовлень (ідентифікатори замовлень Klarna) завжди зберігаються. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Klarna), і віджет Klarna завантажується в оформленні замовлення. Там покупець вибирає оплату одразу, пізніше або частинами, залежно від того, що пропонує Klarna. Коли покупець натискає "Оформити замовлення", Klarna авторизує покупку у віджеті. У блоці Checkout сесія Klarna спершу оновлюється з фінальним кошиком, тож подальші зміни доставки чи сум не призводять до відхилення замовлення Klarna. Потім плагін створює замовлення Klarna на сервері з позиціями, сумами та адресами замовлення WooCommerce.

Результат залежить від статусу перевірки на шахрайство Klarna:

ACCEPTED: замовлення одразу позначається як оплачене, і покупець переходить на сторінку Замовлення отримано. Кошти авторизовано і захоплюється згідно з Capture.

PENDING: замовлення переходить на утримання, доки не надійде сповіщення від Klarna. Не відправляйте його раніше.

REJECTED: замовлення стає Невдалим, і покупець бачить Klarna could not approve this purchase. Please choose another payment method.

Якщо Klarna не може прийняти замовлення, покупець бачить коротке повідомлення, наприклад Klarna could not accept this order. Please check your billing details or choose another payment method., Klarna did not respond. Please try again in a moment. або, коли авторизацію закінчилося, запит натиснути "Оформити замовлення" ще раз. Деталі додаються до приміток замовлення та журналу. Якщо країна виставлення рахунку та валюта покупця не відповідають жодному ринку Klarna вашого регіону, покупець бачить Klarna is not available for your billing country and currency. Please choose another payment method.

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

Плагін не має Klarna Checkout (KCO, повної заміни оформлення замовлення), кнопок Klarna Express Checkout, On-site messaging чи Sign in with Klarna, підписок або збережених способів оплати, а також часткового захоплення за позиціями замовлення. Позиції замовлення не надсилаються до Klarna повторно, коли ви редагуєте замовлення після його розміщення.

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

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

Processing or Completed: Klarna прийняла покупку. WooCommerce встановлює звичайний статус для оплаченого замовлення. У примітці до замовлення показано ID замовлення Klarna і коли його буде захоплено. ID транзакції — це ID замовлення Klarna. Коли замовлення захоплено, у примітці вказано захоплену суму та ID захоплення.

On hold: покупка очікує перевірки на шахрайство, Klarna повернула неочікуваний статус шахрайства, сума або валюта, повідомлені Klarna, не збіглися із замовленням, або захоплення не вдалося. У примітках до замовлення вказано, що саме.

Failed: Klarna відхилила покупку або зупинила її після перевірки на шахрайство. Не відправляйте замовлення.

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

Захоплення

За умови When the order is Completed позначення замовлення як Виконано захоплює суму замовлення. Якщо захоплення не вдалося, наприклад тому, що сума замовлення перевищила авторизовану після редагування, замовлення переходить на утримання з приміткою, що покупця НЕ списано, і покупець не отримує лист "Замовлення виконано". Усуньте проблему і знову позначте замовлення як Виконано, щоб повторити спробу, або захопіть кошти в Klarna Merchant Portal.

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

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

Замовлення, яке ще не захоплено, не можна повернути: натомість скасуйте його, щоб зняти авторизацію. Повернення, виконані в Klarna Merchant Portal, не синхронізуються назад з WooCommerce.

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

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

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

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

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

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

Klarna не з'являється в оформленні замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено і заповнено облікові дані активного режиму: тестове ім'я користувача та пароль у тестовому режимі, робочі — у робочому. Країна виставлення рахунку покупця має бути країною Klarna вашого API region, і покупець має платити у валюті цієї країни (наприклад, покупець зі Швеції має платити в SEK).

Оплату виконано, але замовлення залишається On hold: покупка очікує перевірки на шахрайство Klarna, і замовлення оновиться, коли надійде сповіщення від Klarna. Перевірте, що ваш сайт може отримувати запити від Klarna за URL сповіщень, який показано в налаштуваннях, і що облікові дані середовища, в якому розміщено замовлення, досі введено. Перегляньте WooCommerce > Status > Logs, джерело wcp_klarna_payment.

Сповіщення відповідає Not configured: відсутні облікові дані середовища (тестового або робочого), у якому розміщено замовлення, тому сповіщення неможливо перевірити. Введіть їх.

Сповіщення відповідає Verification failed: замовлення Klarna не вдалося прочитати через Order Management API. Klarna повторить сповіщення.

Сповіщення відповідає mismatch_ref: замовлення Klarna не відповідає цьому замовленню магазину. Замовлення не змінюється.

Віджет не завантажується: покупець бачить Klarna could not be loaded. Please try again or choose another payment method. або Klarna is not available for this purchase. Перевірте облікові дані активного режиму, а також країну та валюту покупця.

Захоплення не вдалося, замовлення On hold: прочитайте примітку до замовлення. Сумі замовлення може бути потрібно більше, ніж ще авторизовано, замовлення Klarna може бути ще не прийнято, або авторизація могла спливти. Усуньте причину і знову позначте замовлення як Виконано, або захопіть кошти в Klarna Merchant Portal.

Повернення не вдалося: прочитайте повідомлення. Замовлення може ще не бути захопленим (тоді скасуйте його), сума може перевищувати той залишок, що можна повернути, або облікові дані середовища замовлення можуть бути відсутні.

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

Видалення

Деактивація плагіна зберігає всі дані. Щоб видалити його, деактивуйте та видаліть на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна завжди видаляються. Налаштування шлюзу та журнали (джерело wcp_klarna_payment) видаляються лише якщо Uninstall (Delete the plugin settings and logs when the plugin is deleted) було увімкнено. Інакше вони зберігаються для повторного встановлення. Наявні замовлення зберігають свої примітки про оплату та ID транзакцій.

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