VibeFox Authorize.Net for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

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

PHP: 8.0 以降。

HTTPS: チェックアウトは HTTPS を使用している必要があります。Accept.js は HTTP では動作しません。

Authorize.Net アカウント: Authorize.Net アカウントの API Login ID、Transaction Key、Public Client Key が必要です。ウェブフックを使う場合は、Signature Key も必要です。本番（account.authorize.net）とサンドボックス（sandbox.authorize.net）のアカウントでは、認証情報が異なります。Authorize.Net のアカウントは、米国、カナダ、英国、ヨーロッパ、オーストラリア、ニュージーランドの加盟店が利用できます。

通貨: ストア通貨は USD、CAD、CHF、DKK、EUR、GBP、NOK、PLN、SEK、AUD、NZD のいずれかで、Authorize.Net アカウントもその通貨で売上を確定できる必要があります。その他の通貨では、チェックアウトで支払い方法は非表示になります。

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

インストール

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

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

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

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

5. サンドボックスと本番アカウントの認証情報を入力します（「設定」の項を参照）。必要に応じてウェブフックを設定します。

6. Enable/Disable をオンにし、Transaction type を選択して保存します。サンドボックスモードで、カード 4111 1111 1111 1111、任意の未来の有効期限、任意の CVV を使って支払いをテストし、その後 Sandbox mode のチェックを外します。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > Authorize.Net。フィールドの上に、サイトが HTTPS を使用していない場合（Accept.js は HTTPS のページでのみ動作します）と、ストア通貨が対応していない場合（その場合、チェックアウトで支払い方法は非表示になります）に警告が表示されます。このページには、選択したモードの認証情報の欄だけが表示されます。

一般

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

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

Description: チェックアウトでカードフォームの上に表示される説明文。既定値: Pay securely with your credit card via Authorize.Net.

API 認証情報

Authorize.Net の Merchant Interface で Account > Settings > Security Settings を開きます。API Credentials & Keys の下で API Login ID をコピーし、Transaction Key と Signature Key を作成します。Manage Public Client Key の下で Public Client Key をコピーします。サンドボックスと本番では、認証情報が異なります。

Sandbox mode: Use the Authorize.Net sandbox (test transactions, no real charges)。API のエンドポイント、Accept.js、以下の認証情報のセットを切り替えます。既定値はオンです。実際の支払いを受け付けるには、チェックを外してください。

Live API Login ID と Sandbox API Login ID: 本番またはサンドボックスアカウントの API Login ID。

Live Transaction Key と Sandbox Transaction Key: そのアカウントの Transaction Key。

Live Public Client Key と Sandbox Public Client Key: ブラウザで Accept.js が使用する公開キー。

Live Signature Key と Sandbox Signature Key: ウェブフックにのみ必要です。各通知の X-ANET-Signature ヘッダーを検証します。

支払い

Transaction type: カードへの請求方法。オーソリは 30 日で期限切れになります。

Authorize and capture: カードに即時請求します。注文は処理中になります（既定値）。

Authorize only: 資金を確保します。注文は保留になります。後から注文操作 Capture payment (Authorize.Net)、または Authorize.Net の管理画面でキャプチャしてください。

ウェブフック（推奨）

ウェブフックがないと、Fraud Detection Suite で保留された注文や、Authorize.Net の管理画面でキャプチャまたはボイドされた注文は、手動で更新する必要があります。Merchant Interface で Account > Settings > Business Settings > Webhooks に移動し、Add Endpoint をクリックします。この設定ページの本項に表示された URL を使用してください。URL は https://your-site/wc-api/wc_authorizenet/ のような形式です。次のイベントを選択します:

net.authorize.payment.fraud.approved: 審査のために保留されたトランザクションが承認されました。

net.authorize.payment.fraud.declined: 審査のために保留されたトランザクションが拒否されました。

net.authorize.payment.priorAuthCapture.created: オーソリがキャプチャされました（例: Authorize.Net の管理画面で）。

net.authorize.payment.void.created: トランザクションがボイドされました。

アカウントの Signature Key を Live Signature Key または Sandbox Signature Key に入力します。有効な署名のないウェブフックは拒否されます。プラグインは、注文を変更する前に、各通知についてトランザクションの現在のステータスと金額を Authorize.Net に問い合わせます。そのため、繰り返し届いた通知によって注文が変更されることはありません。

詳細設定

Debug log: Log API requests and responses を WooCommerce > Status > Logs のソース wcp_authorizenet_gateway に記録します。キー、カードトークン、個人情報はマスクされます。既定値はオフです。

Delete data on uninstall: Remove the settings and the Authorize.Net order meta when the plugin is deleted。既定値はオフです。

チェックアウト

購入者は支払い方法（既定では Credit Card）を選び、チェックアウトページでカード番号、有効期限（MM/YY）、カードコード（CVV）を入力します。サンドボックスモードでは、フォームにテストカード 4111 1111 1111 1111 のヒントが表示されます。注文を確定すると、Accept.js がブラウザでカード情報を 1 回限りのトークンに変換します。カード入力欄にはフォーム名がないため、カード番号と CVV がサーバーに送信されることはありません。

プラグインは、注文の通貨での注文合計額について、Authorize.Net API を通じてトークンに請求します。請求先住所、メールアドレス、IP アドレスは、住所確認と不正フィルターのためにトランザクションとともに送信されます。支払いが承認されると、購入者は注文受付ページに移動し、カートは空になります。

カードが拒否された場合、購入者はチェックアウトに残り、Payment failed: に続けて理由が表示されます。例えば、カードの拒否、カードコードの誤り、カードの期限切れなどです。設定や API のエラーは購入者には表示されません。購入者には一般的なメッセージが表示され、詳細は注文メモとログに記録されます。ストアが Authorize.Net に接続できない場合、購入者には Payment error: unable to connect to the payment gateway. Please try again. と表示されます。

同じ注文の繰り返しの送信や繰り返しの支払いで、二重に請求されることはありません。この支払い方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce の高性能注文ストレージ（HPOS）に対応しています。

このプラグインには、カードの保存や購入者プロファイル、WooCommerce Subscriptions や Pre-Orders、eCheck/ACH、Apple Pay、Google Pay、PayPal、3-D Secure、オーソリの部分キャプチャ、自動の通貨換算はありません。

注文と返金

注文ステータス

Processing or Completed: カードに請求されたか（Authorize and capture）、オーソリがキャプチャされました。WooCommerce は、処理中に設定します。ダウンロード可能な仮想商品のみの注文の場合は、完了に設定します。注文メモには、金額、トランザクション ID、オーソリコード、カードの種類、下 4 桁が表示されます。トランザクション ID は Authorize.Net の Trans ID です。

On hold: 資金はオーソリのみされています（Authorize only）、または Fraud Detection Suite がトランザクションを審査のために保留しました。保留されたトランザクションは、Authorize.Net の管理画面で承認または拒否してください。ウェブフックを設定していれば、注文は自動的に更新されます。ウェブフックで報告されたキャプチャの金額が注文金額と一致しない場合も、注文は保留になります。

Cancelled: 注文が支払い済みになる前に、トランザクションが拒否、ボイド、または期限切れになったとウェブフックが報告しました。支払い済みの注文でこれが起きた場合、そのステータスは変更されず、警告の注文メモが追加されます。

キャプチャ

オーソリがある注文では、注文を開き、注文操作で Capture payment (Authorize.Net) を選び、更新ボタンをクリックします。返金済みの分を差し引いた注文金額全体がキャプチャされ、注文は支払い済みとしてマークされます。キャプチャに失敗した場合、エラーが表示され、注文メモに追加されます。Authorize.Net の管理画面でキャプチャすることもできます。ウェブフックを設定していれば、注文は自動的に更新されます。

返金

注文を開き、Refund をクリックして金額を入力し、Refund via Credit Card をクリックします（ボタンには支払い方法のタイトルが使われます）。注文金額の全額返金では、まだ売上確定していないトランザクション、またはキャプチャされていないオーソリが先にボイドされます。売上確定済みのトランザクションは、通常 24 時間後に、全額または一部を返金できます。売上確定前は一部返金はできません。トランザクションをボイドするには全額返金するか、売上確定後に再試行してください。Authorize.Net がリクエストを受け付けない場合、WooCommerce にエラーが表示され、返金は記録されません。返金またはボイドが成功すると、注文メモに追加されます。

注文の返金、キャプチャ、ウェブフックの確認は、その注文が支払われたモードの認証情報を使用します。そのため、Sandbox mode を切り替えた後も、もう一方のモードの注文はキャプチャと返金ができます。それらの注文が完了するまで、そのモードの認証情報は各欄に残しておいてください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに Authorize.Net が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードに API Login ID、Transaction Key、Public Client Key があることを確認してください。ストア通貨が対応しているかも確認します。対応していない場合、設定ページに警告が表示されます。

支払いは完了したが、注文が On hold のまま: トランザクションの種類が Authorize only である（注文操作でキャプチャしてください）か、Authorize.Net がトランザクションを審査のために保留しています。Authorize.Net の管理画面で承認または拒否してください。このような注文を自動で更新するには、ウェブフックを設定します。エンドポイント URL が設定に表示されたものと正確に一致すること、4 つのイベントが選択されていること、現在のモードの Signature Key が入力されていることを確認してください。

ウェブフックが webhooks are not configured と応答する: どちらのモードにも Signature Key が入力されていません。

ウェブフックが invalid signature と応答する: Signature Key が別のアカウントまたはモードのものです。Signature Key を作成し直すか、もう一度コピーして、そのモードの欄に貼り付けてください。

ウェブフックが verification failed, retry later と応答する: ストアが Authorize.Net API からトランザクションを読み取れませんでした。Authorize.Net が配信を再試行します。

カードフォームが読み込まれない、または The secure card form (Accept.js) could not be loaded と表示される: チェックアウトは HTTPS を使用している必要があります。また、現在のモードの Public Client Key と API Login ID が正しい必要があります。

Payment error: the card could not be tokenized: Accept.js がトークンを返しませんでした。購入者はカード情報を入力し直して、再試行する必要があります。

購入者に一般的なエラーが表示される: 注文メモを開くか、Debug log をオンにして WooCommerce > Status > Logs をソース wcp_authorizenet_gateway で確認してください。アカウントが対応していない通貨は、Authorize.Net によって拒否されます。

売上確定前のため一部返金が失敗する: トランザクションをボイドするには注文金額の全額を返金するか、売上確定後（通常 24 時間以内）に再試行してください。

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

アンインストール

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

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