VibeFox Cardcom for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

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

PHP: 8.0 以降。

HTTPS: Cardcom が決済通知を送信できるよう、サイトは HTTPS でインターネットからアクセスできる必要があります。

通貨: 注文通貨は ILS、USD、EUR、GBP のいずれかである必要があります。それ以外の通貨では、この支払い方法はチェックアウトに表示されません。

Cardcom アカウント: 本番の決済には、ターミナル番号、API ユーザー名、API パスワードを持つ Cardcom の加盟店アカウントが必要です。決済にはターミナル番号と API ユーザー名のみが必要です。API パスワードは、WooCommerce からの返金にのみ使用されます。テストモードは Cardcom アカウントなしで動作します。

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

インストール

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

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

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

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

5. Enable/Disable をオンにし、Test Mode をオンのままにして、カード 4580 0000 0000 0000（有効期限は将来の任意の日付、CVV 123）でテスト注文を行います。

6. 実際の決済を行うには、Test Mode のチェックを外し、Cardcom から受け取った Terminal Number、API Username、API Password を入力します。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > Cardcom。テストモードがオンの間、フィールドの上には Test mode is on. と表示されます。本番モードでは、ターミナル番号または API ユーザー名が欠けていると警告が表示されます（その場合、Cardcom はチェックアウトに表示されません）。また、API パスワードがないと WooCommerce からの返金ができないことも知らせます。ストアの通貨がサポートされていない場合も警告します。ターミナル番号または API ユーザー名がない状態で本番モードを保存すると、入力されるまでゲートウェイがチェックアウトに表示されないことを示すエラーメッセージが表示されます。

一般

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

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

Description: チェックアウトで支払い方法の下に表示される説明文。既定値: Pay securely with your credit card via Cardcom.

テストモード

テストモードでは、公開の Cardcom テストターミナル 1000（API ユーザー CardTest1994）を使用します。実際の料金は請求されず、Cardcom アカウントも不要です。テストカード: 4580 0000 0000 0000、有効期限は将来の任意の日付、CVV 123。テストモードでは、チェックアウトにこのテストカードに関する行も表示されます。

Test Mode: Enable test mode (terminal 1000, no real money)。既定値はオンです。チェックを外すと、以下の本番の認証情報で実際の決済を受け付けます。返金は、常に注文が支払われたモードの認証情報を使って送信されます。

本番の認証情報

ターミナル番号、API ユーザー名、API パスワードは、加盟店アカウントとともに Cardcom から提供されます。Cardcom のダッシュボードの API 設定、または Cardcom サポートから取得します。これらの欄は本番モードでのみ使用されます。

Terminal Number: Cardcom のターミナル番号。数字のみを含める必要があります。それ以外の文字を入力するとエラーが表示され、以前の値が保持されます。

API Username: このターミナルの Cardcom API ユーザー名（ApiName）。保存時にスペースは削除されます。

API Password: Cardcom の API パスワード。WooCommerce からの返金にのみ必要で、入力したとおりに保存されます。

決済ページ

Cardcom は決済通知（IndicatorUrl）を、このセクションに表示されるアドレスに送信します。https://your-site/wc-api/cardcom_p_callback/ のような形式です。このアドレスは、注文 ID とともに各決済で自動的に Cardcom に渡されるため、Cardcom で設定する必要はありません。インターネットからアクセス可能である必要があります。

Operation: Cardcom の決済ページで行う処理。

Charge only: カードに請求されます（既定値）。

Charge + Save token: カードに請求され、さらに Cardcom がカードトークンを作成します。トークンは Cardcom のツールで使用するために注文に保存されます。プラグインは保存されたトークンに自分で請求することはありません。

Max Installments: 購入者が Cardcom のページで選べる分割払いの回数（支払い回数）の上限。1 から 36 の範囲です。1 は分割払いなしを意味します。既定値: 1。

Success Order Status: 決済が確定した後の注文ステータス。ステータスは一度に設定され、2 回目のステータス変更は行われません。

Processing: WooCommerce の既定値（これが既定値です）。

Completed: 支払い済みのすべての注文が完了になります。

On Hold: 支払い済みのすべての注文は、手動での確認を待ちます。

詳細設定

Debug log: Log API requests and notifications を、WooCommerce > Status > Logs のソース wcp_cardcom_payment_gateway に記録します。エラーは常に記録されます。認証情報、カードトークン、カード名義人の詳細は決して記録されません。既定値はオフです。

Delete on Uninstall: Delete all plugin data when uninstalling。オンの場合、プラグインを削除すると、設定、注文に保存された Cardcom のデータ、ログが完全に削除されます。注文そのものは残ります。既定値はオフです。

チェックアウト

購入者は支払い方法（既定では Credit Card (Cardcom)）を選び、注文を確定します。プラグインは、注文通貨で注文合計額について Cardcom の決済ページを作成し、購入者をそこに移動させます。ページは、サイトの言語がヘブライ語の場合はヘブライ語で、それ以外は英語で開きます。注文の商品は、商品名として Cardcom に渡されます。購入者はカード情報を入力し、分割払いが許可されている場合は、支払い回数を選びます。

支払い後、購入者は貴店の注文受付ページに戻ります。注文が支払い済みになるのは、Cardcom が確認した後だけです。Cardcom は通知アドレスを呼び出します。プラグインはその呼び出しから、決済ページのコードのみを取り出します。そのコードが、その注文のために貴店が発行したものかを確認したうえで、Cardcom にサーバー間で実際の結果を問い合わせます。通知が遅れた場合は、購入者が注文受付ページに到着したときに同じ確認が行われます。

決済が完了しなかった場合、Cardcom は購入者をチェックアウト（または Pay for order ページ）に戻します。そこには The card payment was not completed. Please try again or choose a different payment method. と表示されます。Cardcom が確認した拒否された決済は、注文を失敗にします。購入者は未払いの注文を再度支払うことができます（例: Pay for order ページから）。同じ注文の古い決済ページで行われた決済も引き続き認識されます。購入者が別の支払い方法に切り替えたのに Cardcom のページで支払った場合、その決済は記録され、支払い方法は Cardcom に戻されます。

Cardcom が決済ページを開けない場合、購入者には短いメッセージが表示されます。例: Could not connect to Cardcom. Please try again in a moment.、または Cardcom のコードとともに、Cardcom が決済ページを開けなかったというメッセージが表示されます。その後、別の支払い方法を選べます。

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

本プラグインは、Cardcom のページでのカード決済のみに対応しています。保存済みカードやワンクリック決済、定期購読には対応しておらず、保存済みトークンへの請求は行わず、Cardcom の請求書や領収書の設定もありません。Bit、Apple Pay、Google Pay、Cardcom 経由の PayPal はありません。iframe モードと後日キャプチャする取引もありません。放棄された決済ページは自動的に確認されません。

注文と返金

注文ステータス

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

Processing, Completed or On Hold: 決済が確認されました。ステータスは Success Order Status に従います。注文メモには Cardcom の取引が表示され、Cardcom が報告する場合は、カード番号の下 4 桁、請求書番号、分割払いの回数も表示されます。テストの決済には Test mode — no real money was charged. と記録されます。注文の取引 ID は Cardcom の取引番号です。

On hold after payment: Cardcom が、注文と一致しない決済を確認しました。例えば、決済ページを開いた後で注文合計が変更された場合、または異なる金額や通貨が請求された場合です。注文メモに理由が書かれています。Cardcom のダッシュボードで決済と注文を照合し、その後で注文を処理するか、決済を返金してください。

Failed: Cardcom が決済を拒否しました。注文メモには Cardcom の応答コードが表示されます。古い決済ページでの拒否は、新しい試行を失敗にはしません。また、遅れて届いた拒否が支払い済みの注文を変更することもありません。

すでに支払い済みの注文に対して 2 回目の決済が成功した場合（例えば、購入者が 2 つのブラウザータブで支払った場合）、その注文は再び変更されません。注文メモで、購入者が二重に請求された可能性があることを警告し、Cardcom のダッシュボードで返金するよう求めます。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via Credit Card (Cardcom) をクリックします（ボタンには支払い方法のタイトルが表示されます）。全額返金と一部返金に対応しており、1 つの注文に対して複数回の一部返金も可能です。返金は、注文が支払われたモードの認証情報で送信されます。テストの注文は、本番モードに切り替えた後でも Cardcom のテストターミナルで返金され、本番の注文は常に本番の認証情報を使用します。本番の返金には API Username と API Password が必要です。Cardcom が返金を受け付けない場合、WooCommerce にエラーが表示され、返金は記録されません。返金が成功すると、Cardcom の返金取引と理由とともに注文メモに追加されます。

Cardcom のダッシュボードで行われた返金は、貴店に報告されません。必要な場合は、Refund via のゲートウェイ経由ではなく、WooCommerce で手動の返金を作成してください。

ライセンスキー

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

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

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

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

トラブルシューティング

Cardcom がチェックアウトに表示されない: ライセンスが有効であること、Enable/Disable がオンであること、注文通貨が ILS、USD、EUR、GBP のいずれかであることを確認してください。本番モードでは、Terminal Number と API Username が入力されているか確認します。設定ページに不足している項目があると警告が表示されます。

決済は完了したが、注文が Pending payment のまま: Cardcom が貴店のサイトに到達できませんでした。原因は、メンテナンスモード、ファイアウォール、パスワード保護、ローカルの開発サイトなどです。通知アドレスは、HTTPS でインターネットからアクセス可能である必要があります。購入者が注文受付ページに戻ったときにも、注文は確認されます。Debug log をオンにして、WooCommerce > Status > Logs をソース wcp_cardcom_payment_gateway で確認してください。

通知の応答 Missing or invalid lowprofilecode または Unknown lowprofilecode for this order: この呼び出しには、その注文のために貴店が発行した決済ページのコードが含まれていませんでした。注文は変更されません。

通知の応答 Gateway not configured または Indicator check failed: 決済ページを作成したモードの認証情報が不足しているか、確認のために Cardcom に到達できませんでした。注文は変更されず、購入者がストアに戻ったときに再度確認されます。

通知の応答 ReturnValue mismatch または Terminal mismatch: Cardcom が、別の注文または別のターミナルの決済を報告しました。注文は変更されません。Terminal Number がご自身のアカウントのターミナルであることを確認してください。

購入者に Payment error: this currency is not supported by Cardcom.: 注文通貨が ILS、USD、EUR、GBP のいずれでもありません。

購入者に Card payment is temporarily unavailable. Please choose another payment method.: 本番モードがオンですが、ターミナル番号または API ユーザー名が欠けています。

注文の確定時に購入者にエラーが表示される: 注文メモを開くか、Debug log をオンにしてログを確認してください。接続の問題や Cardcom のエラーコードがそこに記録されます。

支払い後に注文が On hold になっている: 注文メモを読んでください。支払われた金額または通貨が、注文と異なっていました。注文を処理するか、決済を返金してください。

返金が失敗する（API username and API password are required for refunds）: 設定で API Password（および API Username）を入力してから、再度お試しください。

返金が失敗する（Could not connect to Cardcom）: 返金が行われた可能性も、行われていない可能性もあるため、再試行する前に Cardcom のダッシュボードを確認してください。

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

開発者向けには、readme に、通貨の一覧を拡張するフィルター cardcom_p_supported_currencies が記載されています（Cardcom のターミナルで有効になっている通貨のみを追加してください）。

アンインストール

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

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