VibeFox Klarna for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 7.0 以降、インストールおよび有効化されていること。WooCommerce がない場合、プラグインは有効化されません。

PHP: 8.0 以降。

HTTPS: Klarna は本番決済に HTTPS を必要とします。

Klarna 加盟店アカウント: 1 つの API リージョンの Klarna 加盟店アカウントの API 認証情報（ユーザー名とパスワード）と、Klarna テストポータルのテスト用認証情報（設定を参照）が必要です。API リージョンごとに認証情報は別々です。1 つのストアで使用できる加盟店アカウントは 1 つ（API リージョン 1 つ）のみです。

ストアの通貨: リージョン内で Klarna が取り扱う通貨: ヨーロッパでは EUR、SEK、NOK、DKK、GBP、CHF、PLN、CZK、HUF、RON；北米では USD、CAD、MXN；オセアニアでは AUD、NZD。

VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。

インストール

1. WordPress で Plugins > Add New > Upload Plugin に移動し、プラグインの ZIP ファイルを選択して Install Now をクリックします。FTP で wcp_klarna_payment フォルダを /wp-content/plugins/ にアップロードすることもできます。

2. Activate をクリックします。

3. 設定を開きます: WooCommerce > Settings > Payments > Klarna Payments > Manage。または、プラグイン画面でプラグイン名の下にある Settings をクリックします。

4. ページ上部のライセンスブロックに VibeFox ライセンスキーを入力し、Activate をクリックします。

5. Klarna 加盟店アカウントの API region を選択します。

6. Klarna テストポータルのテスト用ユーザー名とパスワードを入力し、Test mode をオンのままにして、Enable/Disable をオンにし、テスト注文を行います。

7. Klarna Merchant Portal の本番用ユーザー名とパスワードを入力し、Test mode のチェックを外して、注文をキャプチャするタイミングを選択します（既定: 注文を「完了」にしたとき）。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > Klarna Payments。ページタイトルの横には TEST MODE または LIVE のバッジが表示されます。有効なモードのユーザー名またはパスワードが未入力の場合（その場合、Klarna はチェックアウトに表示されません）や、選択した API リージョンでストアの通貨が Klarna の取り扱い対象外の場合、ページに警告が表示されます。支払い方法の一覧では、有効なモードの認証情報を入力するまで Klarna にセットアップが必要と表示され、テストモードがオンの間はテストモードのバッジが表示されます。

一般

Enable/Disable: Enable Klarna Payments で支払い方法のオン／オフを切り替えます。既定: オフ。

Title: チェックアウトで購入者に表示される支払い方法の名前。既定: Klarna。

Description: Klarna ウィジェットの上に購入者に表示されるテキスト。既定: Pay now, later or in instalments with Klarna.

API 認証情報

Klarna の API 認証情報（ユーザー名とパスワード）は、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 に送信します。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 の注文 ID）は常に保持されます。既定: オフ。

チェックアウト

購入者は支払い方法（既定は Klarna）を選択し、Klarna ウィジェットがチェックアウト内に読み込まれます。そこで購入者は、Klarna が提示する選択肢から今すぐ支払い、後払い、または分割払いを選びます。購入者が「注文する」をクリックすると、Klarna がウィジェット内で購入を承認します。チェックアウトブロックでは、Klarna セッションが最初に最終的なカート内容で更新されるため、その後の配送料や合計の変更によって Klarna が注文を拒否することはありません。その後、プラグインは WooCommerce 注文の注文明細、合計、住所を使って、サーバー側から Klarna 注文を作成します。

結果は 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 ページで利用できます。WooCommerce の High-Performance Order Storage（HPOS）に対応しています。

本プラグインには、Klarna Checkout（KCO、チェックアウトの全面置き換え）、Klarna Express Checkout ボタン、On-site messaging、Sign in with Klarna はありません。また、サブスクリプション、保存済みの支払い方法、注文明細ごとの部分キャプチャにも対応していません。注文が確定した後に注文を編集しても、注文明細は Klarna に再送信されません。

注文と返金

注文ステータス

Processing or Completed: Klarna が購入を承認しました。WooCommerce は、支払い済み注文の通常のステータスを設定します。注文メモには Klarna の注文 ID と、キャプチャされる予定の時期が表示されます。トランザクション ID は Klarna の注文 ID です。注文がキャプチャされると、メモにキャプチャ金額とキャプチャ 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 はエラーを表示し、返金は記録されません。返金が成功すると、Klarna の返金 ID とともに注文メモに追加されます。再試行した返金が二重に実行されることはありません。

まだキャプチャされていない注文は返金できません。代わりにキャンセルして承認を解放してください。Klarna Merchant Portal で行った返金は WooCommerce に同期されません。

ライセンスキー

このプラグインは、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロックは WooCommerce > Settings > Payments > Klarna Payments の上部にあります。キーを License key に貼り付けて、Activate をクリックします。ブロックには、ライセンスが有効な期限日や、お使いのドメインなどのステータスが表示されます。Check now でステータスを再確認し、Change key で別のキーを入力し、Remove key でこのサイトからキーを削除します。Manage licenses and domains in your account のリンクから vibefox.net のアカウントを開けます。

1 つのキーは 1 つのドメインで使用できます。サイトからキーを削除しても、そのドメインの枠は解放されません。vibefox.net のアカウントで枠を解放してください。

有効なキーがない場合、Klarna はチェックアウトで購入者に表示されません。それでも決済が開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。ログインしているストア管理者には、(unlicensed — visible to admins only) と表示された支払い方法が見えるため、キーを購入する前にプラグインを設定してテストできます。プラグイン画面と WooCommerce のページにはリマインダーが表示されます。既存の注文には影響しません。通知は引き続き処理され、キャプチャ、キャンセル、返金も機能します。

ライセンスが期限切れになってもプラグインは動作し続けますが、アップデートとサポートには更新が必要です。ステータスはバックグラウンドで自動的に再確認されます。

トラブルシューティング

Klarna がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、有効なモードの認証情報が入力されていることを確認してください。テストモードではテスト用のユーザー名とパスワード、本番モードでは本番用の認証情報を入力します。購入者の請求先の国は、API region 内の Klarna 対応国である必要があり、その国の通貨で支払う必要があります（たとえばスウェーデンの購入者は SEK で支払う必要があります）。

決済は完了したが、注文が On hold のまま: 購入は Klarna の不正審査中であり、注文は Klarna の通知が届いたときに更新されます。設定に表示されている通知 URL に対して、サイトが Klarna からのリクエストを受信できることを確認してください。また、注文が行われた環境の認証情報がまだ入力されていることも確認してください。WooCommerce > Status > Logs を確認してください（ソース: wcp_klarna_payment）。

通知の応答が Not configured: 注文が行われた環境（テストまたは本番）の認証情報が未入力のため、通知を検証できません。認証情報を入力してください。

通知の応答が Verification failed: Order Management API から Klarna 注文を読み取れませんでした。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 と提携しておらず、Klarna による推奨もありません。