VibeFox Ozow for WooCommerce — ヘルプ

要件

WordPress: 6.2 以降。

WooCommerce: 8.0 以降。インストールされて有効になっている必要があります。WooCommerce がないとプラグインは有効化できません。

PHP: 8.0 以降。

通貨: 南アフリカ・ランド（ZAR）。他の通貨では決済方法が表示されません。Ozow は端数のないセント単位で請求するため、WooCommerce では小数点以下 2 桁を使用してください。

Ozow アカウント: Ozow の加盟店ダッシュボードで確認できる、Ozow サイトの Site Code と Private Key を持つ Ozow 加盟店アカウント。API Key は任意ですが、推奨されています。Ozow はテスト決済と本番決済で同じ Site Code とキーを使用します。

アクセス可能なサイト: Ozow の通知が届くように、サイトはインターネットからアクセス可能である必要があります。メンテナンスモード、パスワード保護、Ozow をブロックするファイアウォールがあってはなりません。

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

インストール

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

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

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

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

5. Ozow の加盟店ダッシュボードから Site Code と Private Key、できれば API Key も入力します。

6. Enable/Disable をオンにします。Test mode をオンにした状態でテスト決済を行い、その後テストモードをオフにして実際の決済を受け付けます。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > Ozow。入力欄の上部には、Site Code または Private Key が未入力の場合（その場合、Ozow はチェックアウトで非表示になります）、ストア通貨が ZAR でない場合、WooCommerce が小数点以下 2 桁を超えて使用している場合に警告が表示されます。テストモードがオンの間は Test mode is on: no real payments are accepted. Do not ship orders paid in test mode. も表示されます。決済方法の一覧では、Site Code と Private Key が入力されるまで、Ozow には設定が必要であると表示されます。

一般

Enable/Disable: Enable Ozow payments で決済方法のオン/オフを切り替えます。初期値：オフ。

Title: 購入者がチェックアウトで目にする決済方法の名称。初期値：Instant EFT (Ozow)。

Description: チェックアウトで決済方法の下に表示されるテキスト。初期値：Pay instantly and securely from your South African bank account. You will be redirected to Ozow to choose your bank and approve the payment。テストモードでは、その下に TEST MODE: no money will be charged. の行が追加されます。

Ozow の認証情報

Ozow の加盟店ダッシュボード（Merchant details / Sites）から Site Code、Private Key、API Key をコピーします。このセクションには、hub.ozow.com にある Ozow の連携ドキュメントへのリンクがあります。

Site Code: 決済を受け取る Ozow サイトの Site Code。別の Site Code 宛ての応答は拒否されます。

Private Key: すべての決済リクエストに署名し、すべての Ozow の応答を検証します。外部に漏らさないでください。これがないと決済方法は非表示になり、Ozow の応答は一切受け付けられません。

API Key (recommended): 任意です。API Key を設定すると、成功したすべての決済は、注文が支払い済みになる前に Ozow GetTransaction API でも確認されます。API は、その注文について、同じ金額、通貨、Site Code で決済が完了したと報告する必要があります。

Test mode: Enable Ozow test mode。Ozow はテストにも同じ Site Code とキーを使用します。決済は IsTest=true で作成され、実際の資金は動きません。テストモードで支払われた注文には注文メモが付きます。発送しないでください。実際の決済を受け付けるには、テストモードをオフにします。テスト決済が本番モードで注文を支払い済みにすることはありません。初期値：オン。

決済通知

通知、成功、キャンセル、エラーの URL は、決済のたびに Ozow へ送信されるため、Ozow の管理画面で設定する必要はありません（Ozow サイトで固定 URL が設定されている場合を除きます）。このセクションには通知 URL が表示されます。その形式は https://your-site/wc-api/ozow_pay/?ozow_notify=1 のようになります。Ozow サイトで固定 URL を使用している場合は、設定に表示されたとおりに正確にコピーしてください。

詳細設定

Debug log: Log payment requests and Ozow responses をオンにすると、詳細が WooCommerce > Status > Logs に、ソース wcp_ozow_pay として記録されます。エラーと警告は常に記録されます。キー、ハッシュ、顧客データは記録されません。初期値：オフ。

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Ozow data saved on orders is kept)。初期値：オフ。

チェックアウト

購入者は決済方法（初期値は Instant EFT (Ozow)）を選択して注文を確定します。プラグインは、ZAR 建ての注文合計に対する署名付きリクエストとともに、購入者を Ozow のホスト決済ページへ案内します。銀行明細上の参照欄は Order と注文番号です（ラテン文字、数字、スペース、ハイフンを合わせて最大 20 文字）。購入者の名前は Ozow に渡されます。Ozow のページで購入者は南アフリカの銀行を選び、銀行アプリで支払いを承認します。

その後、Ozow は貴店に通知し、購入者を戻します。どちらも同じ署名付きの応答を含み、同じ方法で処理されるため、どちらか一方が失われても注文は更新されます。注文は Ozow が確認した後にのみ支払い済みになります。ハッシュは貴店の Private Key で検証できる必要があり、Site Code は貴店のものでなければならず、応答にはこの注文のキーが含まれている必要があり、金額と通貨は注文と一致しなければなりません。API Key を設定している場合は、GetTransaction API でも決済が確認されます。

決済が成功すると、購入者は注文受付ページに移動します。Ozow がまだ決済を確認していない場合、ページには We are waiting for Ozow to confirm your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. と表示されます。注文が保留中の場合は、Your Ozow payment was received and is being reviewed by the store. We will contact you if anything is needed. と表示されます。

購入者が Ozow のページでキャンセルした場合、または決済が失敗した場合、注文は Failed になり、購入者は Pay for order ページに戻ります。そこには The Ozow payment was cancelled. You can try again or choose another payment method. または The Ozow payment was not completed. You can try again or choose another payment method. と表示されます。購入者は同じ注文をもう一度支払うことができます。

この決済方法は、クラシックチェックアウト、Checkout ブロック、Pay for order ページで動作します（ZAR の注文のみ）。WooCommerce High-Performance Order Storage（HPOS）に対応しています。

本プラグインは ZAR による 1 回限りの決済のみに対応しています。WooCommerce からの返金、サブスクリプション、保存済みの銀行口座やトークン化、管理画面からの決済リンクの送信には対応していません。

注文

注文ステータス

Pending payment: 購入者は Ozow に移動しましたが、まだ支払っていないか、Ozow がまだ決済を確認していません。

Processing: 決済が確認されました。これは支払い後の WooCommerce の標準ステータスです。ダウンロード可能な仮想商品のみの注文は、完了（Completed）になります。注文メモには、金額、Ozow のトランザクション ID、および決済が GetTransaction API で確認されたかどうかが表示されます。注文のトランザクション ID は Ozow の TransactionId です。テスト決済には TEST MODE — no money was received, do not ship this order. というメモが付きます。

On hold: 注文メモに理由が記載されます。Ozow または銀行が決済を確認中である（Ozow が最終ステータスを送信すると注文は更新されます）、支払われた金額または通貨が注文と異なる、すでにキャンセルされた注文に対して決済が届いた、あるいは API Key を使用している場合に GetTransaction API が決済をまだ確認できない、または決済と矛盾している、といったケースがあります。Ozow のダッシュボードで決済を確認し、注文ステータスを変更してください。API が応答できなかった場合は、次の Ozow 通知によって注文が完了します。

Failed: 購入者が決済をキャンセルした、決済が中断された、または Ozow がエラーを報告しました。購入者は注文から再度支払うことができます。

すでに支払い済みの注文が未払いに戻ることはなく、キャンセルまたは返金された注文が再開されることもありません。すでに支払い済みの注文に 2 件目の決済が届いた場合は、Ozow のダッシュボードで重複分を返金するようメモで通知されます。注文が別の理由で保留になっている場合（たとえば貴店が設定した場合）、後から届いた決済はメモを追加するだけなので、注文を Processing に変更するのは貴店です。

返金

WooCommerce からの返金はサポートされていません。Ozow の加盟店ダッシュボードで決済を返金し、WooCommerce には返金を手動で記録してください。

ライセンスキー

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

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

有効なキーがない場合、チェックアウトで Ozow は購入者に表示されません。それでも決済が開始された場合、購入者には This payment method is not available. Please choose another one. と表示されます。ログイン中のストア管理者には、決済方法が (unlicensed — visible to admins only) と表示された状態で引き続き表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインの一覧ページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。すでに開始された決済は引き続き確認されます。

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

トラブルシューティング

チェックアウトに Ozow が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、Site Code と Private Key が入力されていること、およびストアまたは注文の通貨が ZAR であることを確認してください。不足がある場合は、設定ページに警告が表示されます。

決済は完了したのに注文が Pending payment のまま: Ozow の通知がストアに届かず、購入者も戻ってきていません。サイトがインターネットからアクセス可能か（メンテナンスモード、パスワード保護、Ozow をブロックするファイアウォールがないか）を確認してください。Ozow サイトで固定 URL を使用している場合は、通知 URL が設定に表示されたものと正確に一致しているか確認してください。Debug log をオンにして、WooCommerce > Status > Logs のソース wcp_ozow_pay を確認してください。

通知が Invalid hash と応答する: 設定の Private Key が、応答を送信した Ozow サイトのものではありません。Ozow の加盟店ダッシュボードから再度コピーしてください。

通知が Unknown site と応答する: 応答が別の Ozow サイトから届きました。Site Code を確認してください。

通知が Order mismatch または Order not found と応答する: 応答は、このストアの注文に属していません。何も変更されません。

通知が Gateway not configured と応答する: Site Code または Private Key が未入力です。入力してください。Ozow は再試行する場合があります。

通知が Order busy と応答する: 同じ注文に対する別の Ozow の応答が、同時に処理されていました。この応答は適用されません。次の通知または購入者の戻りで適用されます。

通知が Payment not confirmed yet と応答する: API Key を使用している場合、GetTransaction API が決済を確認できませんでした。注文は保留になり、次の通知で完了します。保留のままの場合は、API Key と Ozow のダッシュボードで決済を確認してください。

購入者に Ozow accepts payments in South African rand (ZAR) only と表示される: 注文が別の通貨です。この注文には Ozow を使用できません。

テスト決済で注文が支払い済みにならなかった: ゲートウェイは本番モードです。テスト決済が本番モードで注文を支払い済みにすることはありません。注文にはその旨のメモが付きます。

決済後に注文が On hold になる: 注文メモを確認し、Ozow のダッシュボードで決済を確認してから、注文を Processing に設定するか、Ozow で決済を返金してください。

ライセンスブロックにエラーが表示される: ブロック内のメッセージに従ってください。たとえば、キーが別のドメインですでに使用されている場合は、vibefox.net のアカウントで枠を解放し、Check now をクリックしてください。サイトのアドレスが変わった場合は、Check now をクリックして新しいドメインでキーを有効にしてください。ライセンスサーバーに接続できない場合、プラグインは最後に確認されたステータスで動作を続けます。

アンインストール

プラグインを無効化してもすべてのデータは保持されます。削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンスステータスは常に削除されます。ゲートウェイの設定、プラグインのその他のオプション、ログは、Delete data on uninstall がオンの場合にのみ削除されます。それ以外の場合は、後で再インストールする際のために残ります。既存の注文は、決済メモとトランザクション ID を保持します。

Ozow は各所有者の商標です。本プラグインは Ozow と提携しておらず、Ozow の承認も受けていません。