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 подтверждает покупку в виджете. В блоке «Оформление заказа» сессия 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.

Способ оплаты работает в классическом оформлении заказа, в блоке «Оформление заказа» и на странице 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 присваивает обычный статус оплаченного заказа. В примечании к заказу показан идентификатор заказа Klarna и время, когда он будет списан. Идентификатор транзакции — это идентификатор заказа Klarna. Когда заказ списан, примечание показывает списанную сумму и идентификатор списания.

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 показывает ошибку и возврат не записывается. Успешный возврат добавляется в примечания к заказу с идентификатором возврата 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) был включён. Иначе они сохраняются для повторной установки. Существующие заказы сохраняют свои платёжные примечания и идентификаторы транзакций.

Klarna — товарный знак её владельца. Этот плагин не связан с Klarna и не одобрен ею.