VibeFox Flow for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 8.0 以降。インストール済みで有効であること。

PHP: 8.0 以降。

ストア通貨：チリペソ（CLP）または米ドル（USD）。他の通貨ではチェックアウトで決済方法が非表示になります。Flow は整数のペソを請求するため、CLP のストアでは WooCommerce > Settings > General > Number of decimals を 0 に設定してください。

Flow アカウント：Flow の Mis datos、Datos técnicos にある、貴店の Flow アカウントの API Key と Secret Key が必要です。テストには sandbox.flow.cl で別のサンドボックスアカウントを作成し、そのキーを使用してください。サンドボックスと本番のキーは異なります。Flow アカウントでの設定は不要です。

公開ウェブサイト：貴店の確認、戻り先、返金の URL はインターネットからアクセス可能である必要があります。メンテナンスモード、パスワード保護、Flow を遮断するファイアウォールは使用できません。

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

インストール

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

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

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

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

5. サンドボックスの API Key と Secret Key を入力し、Enable / Disable を有効にして保存し、テスト注文を行います。

6. 実際の決済を受け付けるには、本番のキーを入力し、Sandbox mode のチェックを外します。

設定

設定はすべて 1 つのページにあります：WooCommerce > Settings > Payments > Flow.cl。現在のモードのキーが空の場合（チェックアウトで Flow が非表示になります）、ストア通貨が未対応の場合、CLP のストアが小数を使用している場合に、フィールドの上に警告が表示されます（Flow は整数のペソを請求するため、価格、合計、返金額が正確に一致するよう Number of decimals を 0 に設定してください）。サンドボックスモードでは Sandbox mode と表示され、決済は sandbox.flow.cl に送信され、実際の請求は発生しません。決済方法一覧では、現在のモードのキーが設定されるまで Flow に設定が必要な表示が付き、サンドボックスモードではテストモードのバッジが表示されます。

一般

Enable / Disable: Enable Flow.cl payments で決済方法を有効または無効にします。初期値：オフ。

Title: チェックアウトで購入者に表示される決済方法の名前です。初期値：Flow。

Description: チェックアウトの決済方法の下に表示されるテキストです。初期値：Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.

Flow API 認証情報

Flow アカウント（Mis datos、Datos técnicos）から API Key と Secret Key をコピーします。本番のキーは www.flow.cl、サンドボックスのキーは sandbox.flow.cl（別のサンドボックスアカウント）にあります。

Sandbox mode: Use the Flow sandbox (sandbox.flow.cl) and the sandbox keys。サンドボックスモードでは実際の請求は発生しません。初期値：オン。実際の決済を受け付けるには、このモードを無効にして本番のキーを入力します。返金には常に注文が支払われた環境を使用します。

Sandbox API Key: sandbox.flow.cl アカウントの API Key です。

Sandbox Secret Key: sandbox.flow.cl アカウントの Secret Key です。すべてのリクエストの署名に使用します。

Live API Key: www.flow.cl アカウントの API Key です。

Live Secret Key: www.flow.cl アカウントの Secret Key です。秘密に保管してください。

通知

プラグインは決済と返金のたびに 3 つの URL を Flow に送信するため、Flow アカウントでの設定は不要です。このセクションには次の URL が表示されます。

確認通知に含まれるのは決済トークンだけです。その後、プラグインは決済が作成された環境で署名付きリクエストにより Flow に決済ステータスを問い合わせ、Flow の回答のみを適用します。このストアがその注文用に作成していない決済は拒否されます。確認通知がなくても、購入者が Flow から戻った際に注文が更新されます。

詳細設定

Debug log: Log API calls and notifications を WooCommerce > Status > Logs に記録します。ソースは wcp_flow_gateway で、キーや購入者データは含みません。エラーは常に記録されます。初期値：オフ。

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

チェックアウト

購入者は決済方法（初期設定は Flow）を選び、注文します。サンドボックスモードではチェックアウトに SANDBOX MODE と表示され、決済は Flow のサンドボックスに送信されます。実際の請求は発生しません。有効な請求先メールアドレスが必要です。プラグインは注文通貨で注文合計額の Flow 決済を作成します。件名は Order # に注文番号とサイト名を加えたもので、購入者は Flow の決済ページに移動します。そこで貴店の Flow アカウントで有効な決済方法を選びます。

支払い後、購入者はストアに戻ります。注文が支払い済みになるのは Flow が確認した後だけです。確認通知、または購入者が戻った際の署名付きステータスリクエストで確認します。支払い済みの注文、または支払い待ちの現金払いクーポンの場合、注文受付ページに進みます。

決済が拒否された場合、購入者は Your Flow payment was rejected. Please try again or choose another payment method. とともに Pay for order ページ（またはチェックアウト）に戻ります。支払わずに Flow ページを離れた場合、メッセージは The Flow payment was not completed. You can try again or choose another payment method. です。結果を確認できなかった場合、メッセージは We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly; otherwise please try again. です。再試行するたびに、注文に紐づく新しい Flow 決済が作成されます。

Flow が決済を開始できない場合、購入者には短いメッセージが表示されます。例：Could not connect to Flow. Please try again in a moment. 詳細はログに記録されます。

この決済方法はクラシックチェックアウト、チェックアウトブロック、Pay for order ページで使用できます。WooCommerce High-Performance Order Storage（HPOS）に対応しています。購入者向けテキストはスペイン語（チリとスペイン）に翻訳されています。

プラグインは単発決済のみを受け付けます。保存済みカード、サブスクリプション、継続課金、決済リンクには対応せず、Flow 決済方法を事前選択しません。Flow は作成済みの決済リンクをキャンセルできません。購入者が新しいリンクで支払った後に古いリンクでも支払った場合、Flow で重複分を返金するよう求めるメモが注文に追加されます。

注文と返金

注文ステータス

Pending payment: 購入者は Flow に移動しましたが、まだ支払っていません。注文メモに、その試行の金額と Flow 注文番号が表示されます。

On hold, awaiting coupon payment: 購入者が Servipag または Multicaja の決済クーポンを発行しました。Flow が支払いを確認すると注文が変更されます。

Processing: Flow が支払い済みと報告し、金額と通貨が一致しています（バーチャルかつダウンロード可能な商品のみの注文は、WooCommerce の標準動作で完了になります）。注文メモには金額と Flow 注文番号が表示されます。注文の取引 ID は Flow 注文番号です。

On hold, amount/currency mismatch: Flow が注文と異なる金額または通貨を報告しました。注文は支払い済みになっていません。手動で確認してください。

On hold, payment for a cancelled order: 未払いのままキャンセルされた注文に対して支払いが届きました。注文を確認して発送するか、Flow で返金してください。

Failed: Flow が未払い注文の最新の決済試行を拒否しました。購入者は再試行できます。

Cancelled: 最新の決済試行が Flow で取り消されました。

支払い済みの注文に別の支払いが届いても、注文は変更されません。Flow アカウントで重複分を返金するよう求めるメモが追加されます。支払い後にキャンセルまたは返金された注文は再開されません。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via Flow をクリックします。全額返金と一部返金に対応しています。返金は注文が支払われた環境（サンドボックスまたは本番）に送信されるため、その環境のキーが設定され、注文に請求先メールアドレスが必要です。Flow は返金を完了するためのメールを購入者に送ります。Flow が返金を拒否した場合、WooCommerce にエラーが表示され、返金は記録されません。成功したリクエストは Flow の返金番号とステータスとともに注文メモに追加されます。

Flow が報告する以後の返金ステータス変更は注文メモに追加されます。Flow が後で返金を拒否またはキャンセルした場合、購入者に返金されなかったことがメモに記載されます。WooCommerce の返金記録は残るため、手動で対応してください。Flow ダッシュボードで作成した返金は WooCommerce にインポートされません。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに Flow が表示されない：ライセンスが有効で、Enable / Disable がオンになり、現在のモードのキーが入力されていること（サンドボックスモードではサンドボックスのキー、本番モードでは本番のキー）、ストア通貨が CLP または USD であることを確認してください。Pay for order ページでは注文通貨を確認します。

支払いは成功したが注文がPending paymentのまま：Flow の確認通知が貴店に届かず、購入者も戻っていません。設定に表示された確認 URL がインターネットから開けること、メンテナンスモード、パスワード保護、ファイアウォールで遮断されていないことを確認してください。Debug log をオンにし、WooCommerce > Status > Logs のソース wcp_flow_gateway を確認します。

確認通知が Payment does not belong to the order または Unknown order と応答する：この決済はこのストアがこの注文用に作成したものではないか、別の環境で作成されたものです。注文は変更されません。

確認通知が Gateway not configured と応答する：決済環境のキーが空です。再入力してください。

確認通知が Flow API unavailable と応答する：Flow へのステータスリクエストが失敗しました。Flow が確認通知を再送します。

購入者に Flow payments are not available at the moment と表示される：キーが未入力か、Flow がキーを拒否しています。現在のモードの API Key と Secret Key を確認してください。

購入者に A valid billing email is required for Flow payments と表示される：Flow には購入者のメールアドレスが必要です。

購入者が支払ったが注文がOn hold：注文メモを確認してください。購入者が未払いの現金払いクーポンを発行したか、Flow が報告した金額または通貨が注文と一致していません。小数を含む CLP 合計は整数のペソに丸められるため、Number of decimals を 0 に設定してください。

サンドボックスまたは本番のキーに関するメッセージで返金が失敗する：注文はその環境で支払われましたが、キーが空です。入力して再試行してください。

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

開発者向けに、readme にはフィルター wc_flw_supported_currencies（ゲートウェイを提供する通貨）が記載されています。

アンインストール

プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページで無効化して削除します。このプラグインのライセンスキーとライセンス状態は常に削除されます。ゲートウェイ設定とログは、Delete data on uninstall がオンだった場合のみ削除されます。それ以外は後の再インストール用に残ります。注文に保存された Flow データは常に保持されます。既存の注文の決済メモと取引 ID も保持されます。

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