VibeFox 2C2P for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 6.0 以降がインストールされ、有効になっていること。WooCommerce がない場合、プラグインは管理画面に通知を表示し、支払い方法は読み込まれません。

PHP: 8.0 以降。

2C2P アカウント: 2C2P の加盟店アカウントの Merchant ID と Secret Key が必要です。これらは、加盟店アカウントの開設時に 2C2P から発行されます。サンドボックスと本番のアカウントでは、キーが異なります。開発者向けドキュメントとサンドボックスのテストカードは developer.2c2p.com にあります。

通貨: ストア通貨がプラグインで対応しており、2C2P アカウントで有効になっている必要があります。対応している通貨は、THB、SGD、MYR、PHP、IDR、VND、MMK、KHR、LAK、CNY、HKD、TWD、JPY、KRW、INR、AUD、NZD、USD、EUR、GBP などです。ストア通貨が対応していない場合、チェックアウトで支払い方法は非表示になります。

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

インストール

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

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

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

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

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

6. 準備ができたら、本番の認証情報を入力し、Sandbox Mode のチェックを外します。

戻り先 URL と通知 URL はすべての支払いに送られます。2C2P のポータルで何も設定する必要はありません。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > 2C2P。サンドボックスモードがオンの間、設定欄の上に Sandbox mode is active. No real transactions will be processed. と表示されます。決済ゲートウェイが有効になっているのに現在のモードの Merchant ID または Secret Key が空の場合、また、ストア通貨が対応していない場合にも警告が表示されます。どちらの場合も、チェックアウトで支払い方法は非表示になります。Sandbox Mode をオフにして保存するとき、本番の Merchant ID と Secret Key が空であれば、プラグインは入力を求めます。

一般

Enable/Disable: Enable 2C2P Payment Gateway で支払い方法をオンまたはオフにします。既定値はオフです。

Title: 購入者がチェックアウトで見る支払い方法の名前。既定値: 2C2P Payment。

Description: チェックアウトで支払い方法の下に表示される説明文。既定値: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. サンドボックスモードでは、その後に (TEST MODE) が追加されます。

テストモード（サンドボックス）

Sandbox Mode: Enable sandbox / test mode は、以下のサンドボックスの認証情報を使って、支払いを 2C2P のサンドボックス（demo2.2c2p.com）に送信します。既定値はオンです。実際の支払いを受け付けるには、チェックを外してください。

Sandbox Merchant ID: お使いの 2C2P サンドボックスの Merchant ID。

Sandbox Secret Key: お使いの 2C2P サンドボックスの Secret Key。

本番 API の認証情報

サンドボックスモードがオフの場合に使用されます。

Merchant ID: お使いの 2C2P 本番の Merchant ID。サンドボックスモードがオフの場合は必須です。

Secret Key: お使いの 2C2P 本番の Secret Key。サンドボックスモードがオフの場合は必須です。キーは、引用符やバックスラッシュを含め、入力したとおりに保存されます。

決済ページ

この項目には、参考として、フロントエンドの戻り先 URL（https://your-site/?wc-api=tc2p_p）と、バックエンドの通知 URL（https://your-site/?wc-api=tc2p_p&tc2p_p_s2s=1）が表示されます。これらはすべての支払いで自動的に送信されます。

Payment Page Language: 2C2P 決済ページの言語。既定値: English。

Options: English, Thai, Japanese, Bahasa Indonesia, Burmese, Simplified Chinese.

Redirect API version: 2C2P から古いバージョン 7.0（SHA-1 署名）を使用していると通知されない限り、8.5 のままにしてください。切り替え前に開始された支払いの結果も、引き続き検証されます。

8.5 — HMAC-SHA256 (recommended): 現在のバージョン（既定値）。

7.0 — HMAC-SHA1 (legacy accounts): 古い 2C2P アカウント向け。

Order ID prefix: 任意。英字と数字のみ（最大 10 文字）。例: SHOP1。2C2P は、すでに使われた注文 ID を受け付けません。同じ 2C2P アカウントを複数のストアで共有する場合や、テスト用の加盟店アカウントが多くの開発者に共有されているサンドボックスでは、一意のプレフィックスを設定してください。その他の文字は、保存時に警告付きで削除されます。

詳細設定

Enable Logging: Log 2C2P events は、WooCommerce > Status > Logs のソース wcp_2c2p_payment に書き込みます。カード情報やシークレットキーはログに記録されません。既定値はオフです。

Delete Data on Uninstall: Delete the gateway settings, 2C2P order meta and log files when the plugin is deleted。既定値はオフです。

チェックアウト

購入者は支払い方法（既定では 2C2P Payment）を選び、注文を確定します。次のページには Thank you for your order. You will be redirected to 2C2P to complete your payment. と表示され、しばらくすると購入者は 2C2P の決済ページに移動します。移動しない場合、購入者は Pay via 2C2P をクリックします。このページには Cancel order ボタンもあります。

2C2P の決済ページで、購入者は 2C2P アカウントで有効になっている任意の方法（クレジットカード、電子ウォレット、QR 決済、インターネットバンキング、現金払いなど）で支払います。プラグインは、注文合計額を注文の通貨で、購入者の請求先メールアドレス、注文した商品の名前とともに送信します。支払いは 24 時間以内に完了できます。

2C2P は結果を 2 回報告します。購入者のブラウザがストアに戻ってくるときと、2C2P がサーバー間通知を送るときです。どちらも同じように処理されます。注文が支払い済みになるのは、2C2P が有効な署名付きで確認した後だけです。結果は注文に属している必要もあり、加盟店 ID、注文キー、注文 ID、支払い方法が確認されます。有効な署名のない結果は拒否されます。

支払いが成功または保留になった後、購入者は注文受付ページに移動し、カートは空になります。支払いが完了しなかった場合、購入者は Payment was not completed. Please try again or choose a different payment method. というメッセージとともにチェックアウトに戻ります。注文はキャンセルされ、カートは残るため、購入者は新しい注文を出し直せます。結果を確認できない場合、購入者には We could not confirm the payment result. If your account was charged, please contact us before paying again. と表示されます。

この支払い方法は、クラシックチェックアウトとチェックアウトブロックの両方で動作します。WooCommerce の高性能注文ストレージ（HPOS）に対応しています。

このプラグインには、WooCommerce からの返金、カードの保存、定期払い、WooCommerce Subscriptions、お使いのサイト上のカード入力欄はなく、2C2P PGW 4.x API にも対応していません。

注文

注文ステータス

Pending payment: 購入者は 2C2P に移動しましたが、まだ結果は届いていません。

Processing or Completed: 2C2P が支払いの成功を報告しました（ステータス 000）。WooCommerce は、処理中に設定します。ダウンロード可能な仮想商品のみの注文の場合は、完了に設定します。注文メモには、2C2P のトランザクション、承認コード、日付、支払いチャネルが表示されます。トランザクション ID は、2C2P のトランザクション参照番号です。

On hold: 2C2P で支払いが保留中です（ステータス 001）。例えば、購入者がまだ支払っていない現金払いなどです。2C2P が支払いを報告すると、注文は支払い済みになります。2C2P が注文合計と異なる金額または通貨を報告した場合も、注文は保留になります。注文メモには、受け取った値と想定していた値が表示されます。2C2P のポータルで注文とトランザクションを確認してください。

Cancelled: 支払いが拒否されたか、購入者によってキャンセルされたか、失敗しました（ステータス 002、003、999）。注文メモには、ステータスと理由が表示されます。

支払い済みまたは返金済みの注文は、後から届いた結果によって変更されることはありません。また、古い結果が再送されても、キャンセルした注文が再び開かれることはありません。

返金

WooCommerce からの返金はサポートされていません。2C2P の加盟店ポータルで支払いを返金し、その後 WooCommerce で手動の返金を作成してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに 2C2P が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードに Merchant ID と Secret Key があることを確認してください（サンドボックスモードではサンドボックスの欄、本番モードでは本番の欄）。ストア通貨が対応しているかも確認します。どちらの場合も、設定ページに警告が表示されます。

支払いは完了したが、注文が Pending payment のまま: 有効な結果がストアに届いていません。現在のモードの Merchant ID と Secret Key が、支払いを行った 2C2P アカウントと一致しているか、Redirect API version がアカウントと一致しているかを確認してください。署名が誤っている結果や、別の Merchant ID の結果は拒否されます。Enable Logging をオンにし、WooCommerce > Status > Logs で hash や merchant ID に関するメッセージを確認してください。また、サーバーが 2C2P からバックエンドの通知 URL へのリクエストを受け付けているかも確認してください。

2C2P が注文 ID は既に存在すると表示する: 2C2P は同じ注文 ID を 2 回受け付けません。これは、同じ 2C2P アカウントを複数のストアで共有している場合や、デモ用の加盟店アカウントを多くの開発者が共有しているサンドボックスで発生します。一意の Order ID prefix を設定してください。

支払いは行われたが、注文が On hold になっている: 2C2P で支払いがまだ保留中（例: 購入者がまだ支払っていない現金払い）か、支払われた金額または通貨が注文と一致しなかったかのどちらかです。注文メモと 2C2P のポータルのトランザクションを確認してください。

購入者に This payment method is currently unavailable for this order と表示される: 注文の通貨が対応していないか、現在のモードの Merchant ID または Secret Key が空です。

保存時に Please enter your live Merchant ID または Please enter your live Secret Key と表示される: サンドボックスモードがオフで、本番の欄が空です。本番の認証情報を入力するか、Sandbox Mode をオンのままにしてください。

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

アンインストール

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

2C2P は、それぞれの所有者の商標です。このプラグインは 2C2P と提携しておらず、2C2P による推奨も受けていません。