VibeFox Tranzila for WooCommerce — ヘルプ

要件

WordPress：6.0 以降。

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

PHP：8.0 以降。

ストアの通貨：ILS、USD、EUR、GBP。それ以外の通貨の場合、チェックアウト時に支払い方法が表示されません。

Tranzila の端末：端末名が必要です。端末パスワード（TranzilaPW）は handshake と、WooCommerce からの返金に必要です。端末によっては、返金用に別途クレジットパスワード（CreditPass）が必要な場合もあります。端末名とパスワードは Tranzila から提供されます。端末の設定を確認するか、Tranzila のサポートにお問い合わせください。Tranzila には公開のサンドボックスはありません。テスト用には、Tranzila から別のテスト端末が提供されます。その端末名を端末名として入力してください。

実際の訪問者の IP アドレス：支払い通知は Tranzila サーバーの IP アドレスと照合されます。サイトが Cloudflare などのプロキシや CDN の背後にある場合、Web サーバーは実際の訪問者の IP アドレスを PHP（REMOTE_ADDR）に渡す必要があります。

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

インストール

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

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

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

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

5. Terminal name (supplier) を入力し、handshake または返金を使用する場合は Terminal password (TranzilaPW) も入力します。

6. Notifications を有効のままにし、Trusted IP を確認します。ここには、Tranzila が通知を送信する IP アドレスを記載する必要があります。このリストは Tranzila のサポートに確認してください。

7. 推奨：Tranzila の端末で handshake を有効にし、そこでお使いのサーバーの IP アドレスを許可してから、プラグインで Handshake を有効にします。

8. Enable/Disable を有効にし、Tranzila のテスト端末で支払いをテストします。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > Tranzila。フィールドの上では、端末名が空の場合（その場合、チェックアウトで支払い方法が表示されません）、通知が無効の場合、または Trusted IP が空の場合（その場合、支払い済みの注文は手動確認のため保留になります）、端末パスワードなしで handshake が有効な場合（支払いページを開けません）、ストアの通貨がサポートされていない場合に、ページが警告を表示します。保存時、無効な端末名や無効な Trusted IP のエントリは保存されず、ページにエラーが表示され、前の値が維持されます。許容範囲外の数値は、最も近い許容値に修正されます。

General

Enable/Disable：Enable Tranzila Payment Gateway で支払い方法を有効または無効にします。既定値：無効。

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

Description：チェックアウトで支払い方法の下に表示されるテキスト。既定値：Pay securely with your credit card on the Tranzila payment page.

Terminal

Terminal name (supplier)：Tranzila の端末名（例：myshop）。使用できるのは英字、数字、「-」、「_」のみです。入力されるまで、チェックアウトで支払い方法は表示されません。テスト時は、Tranzila のテスト端末の名前を入力してください。

Terminal password (TranzilaPW)：端末の API パスワード。handshake と、WooCommerce からの返金に必要です。

Refund password (CreditPass)：端末がクレジット（返金）取引に別のパスワードを要求する場合にのみ入力します。それ以外の場合は空欄のままにしてください。

Payment page

Payment page version：iframe に表示される Tranzila のページ。

Payment page language：Tranzila のページの言語：Site language、Hebrew、English、Russian、Spanish、German、French、Japanese。既定値：Hebrew。Site language は、訪問者の WordPress のロケールがこれらのいずれかである場合にその言語を使用し、それ以外の場合は English を使用します。

iFrame width (px)：300 〜 1200。既定値：600。小さい画面では、フレームがページより広くなることはありません。

iFrame height (px)：400 〜 1500。既定値：650。

Max installments：支払いページで購入者が選択できる分割回数（tashlumim）の上限。最大 36 回です。0 または 1 は分割なしを意味します。既定値：0。端末で分割処理が許可されている必要があります。

Handshake：Lock the amount with a handshake token (recommended)。支払いページを開く前に、ストアは注文金額に紐付けられた使い捨てトークンを Tranzila に要求します。これにより、ブラウザ上で金額を変更できなくなります。端末パスワード、Tranzila の端末で handshake が有効であること、およびサーバーの IP アドレスがそこで許可されていることが必要です。既定値：無効。

Payment confirmation

Tranzila の通知には署名がありません。注文は、通知が Trusted IP から届き、かつ注文キー、端末、金額、通貨が注文と一致する場合にのみ、支払い済みになります。handshake が有効な場合、トークンも注文の支払いページと一致する必要があります。購入者が支払いページから戻っただけでは、注文が支払い済みになることはありません。

Notifications：Confirm payments automatically with Tranzila notifications (notify URL)。既定値：有効。通知 URL は、すべての支払いとともに Tranzila に送信されるため、Tranzila の端末に入力する必要はありません。URL の例は https://your-site/wc-api/tranzila_p_callback/ で、フィールドの下に表示されます。通知が無効の場合、支払いが成功したページから戻った購入者の注文は保留になり、Tranzila の端末で確認した後、手動で支払いを確定します。

Trusted IP：通知を送信する Tranzila サーバーの IP アドレスまたは CIDR 範囲を、カンマで区切って入力します。既定値：80.244.170.7。現在のリストは Tranzila のサポートに確認してください。それ以外のアドレスからの通知は拒否されます。このフィールドが空の場合、通知を検証できません。成功と報告された支払いは、手動確認のために注文を保留にし、拒否と報告された支払いは注文を変更しません。

Advanced

Debug log：Log payment page, notification and refund events は、WooCommerce > Status > Logs に、ソース wcp_tranzila_payment_gateway として記録されます。このオプションが無効でも、エラーは常に記録されます。パスワード、トークン、購入者のデータは一切記録されません。既定値：無効。

Delete data on uninstall：Delete the settings, logs and Tranzila order data when the plugin is deleted。既定値：無効。

チェックアウト

購入者は支払い方法（既定では Credit Card (Tranzila)）を選び、Continue to payment をクリックします。注文は支払い待ちのステータスで作成され、購入者は貴店の注文支払いページに移動します。そこでは、注文合計（注文の通貨）、請求先情報、注文商品の簡単な一覧とともに、Tranzila の支払いページが iframe 内に開きます。ページには Enter your card details on the secure Tranzila payment page below. If it does not load, click "Proceed to payment". と表示されます。フレームの下には Choose another payment method のリンクがあります。分割払いが許可されている場合、購入者は Tranzila のページで分割回数を選択します。

支払いが成功すると、Tranzila は購入者を戻し、ウィンドウ全体が貴店の注文受付ページに切り替わります。注文は、Tranzila が通知で確認した後にのみ支払い済みになります。それまでは、ページに Your payment is being confirmed by Tranzila. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. と表示されます。注文が確認のために保留になっている場合は、Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed. と表示されます。

支払いが拒否またはキャンセルされた場合、購入者は The payment was not completed. You have not been charged — please try again or choose another payment method. というメッセージとともに、注文の支払いページに戻ります。Tranzila が応答コードを返した場合は、その理由とコードが追加されます。たとえば、カードの有効期限が切れている、といった内容です。購入者は再度支払うか、別の支払い方法を選択できます。

支払いページを開けない場合（たとえば handshake が失敗した場合）、購入者には Could not connect to Tranzila. Please try again in a moment. のような短いメッセージと、Choose another payment method のリンクが表示されます。技術的な理由はログに記録されます。

この支払い方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで機能します。Pay for order ページでは、注文の通貨がサポートされている場合に提供されます。WooCommerce High-Performance Order Storage（HPOS）に対応しています。

プラグインは、Tranzila のページ上での単発のカード決済のみに対応しています。保存済みのカードやトークン、サブスクリプション、オーソリと売上確定の分離（J5）、独自の Bit、Apple Pay、Google Pay ボタンには対応していません（Tranzila の支払いページが提供するものは、iframe 内に表示されます）。また、Tranzila の請求書にも対応していません。

注文と返金

Order statuses

Pending payment：購入者は支払いページに案内されましたが、まだ支払っていないか、Tranzila の通知がまだ届いていません。

Processing or Completed：支払いは、検証済みの通知によって確認されました。WooCommerce は Processing を設定します。配送の必要がない注文の場合は Completed を設定します。注文メモには、金額、Tranzila の取引、承認番号が表示されます。分割払いがある場合は、分割回数も表示されます。取引 ID は Tranzila の取引インデックスです。

On hold：支払いは受け付けられましたが、自動的には承認されませんでした。金額、通貨、または handshake トークンが注文と一致しなかったか、Trusted IP が空のため通知を検証できなかったか、通知がオフで購入者が支払いが成功したページから戻ってきた場合です。注文メモに理由が記載されています。Tranzila の端末で支払いを確認し、ステータスを手動で変更してください。

Failed：Tranzila が、保留中の注文について支払いの拒否を報告しました。メモには、応答コードとその意味が表示されます。すでに支払い済みの注文が Failed に設定されることはありません。

キャンセルされた注文に対して支払いが届いた場合、注文は再度開かれ、出荷前に在庫を確認するよう求めるメモが追加されます。購入者が Pay for order ページで別の支払い方法に切り替えたものの、まだ開いていた Tranzila のページで支払った場合、注文の支払い方法は Tranzila に戻されます。すでに支払い済み、完了済み、または返金済みの注文に 2 回目の支払いが届いた場合、注文は変更されません。メモで確認を求め、Tranzila の端末で重複分を返金するよう促します。同じ取引の繰り返しの通知は無視されます。

Refunds

注文を開き、Refund をクリックし、金額を入力して Refund via Credit Card (Tranzila) をクリックします（ボタンには支払い方法のタイトルが表示されます）。全額返金と一部返金に対応しています。返金は、元の支払いに対する Tranzila のクレジット取引として行われます。このボタンは、端末パスワードが設定され、注文に承認番号付きの確認済み Tranzila 取引がある場合に利用できます。返金が成功すると、Tranzila のクレジット取引とともに注文メモに追加されます。

Tranzila が返金を受け付けない場合、WooCommerce はエラーを表示します。たとえば、コード付きの Tranzila declined the refund です。その場合、返金は記録されません。現在の設定とは別の端末（たとえばテスト端末）で支払われた注文は WooCommerce から返金できません。その Tranzila 端末で返金してください。Tranzila の端末で行われた返金は、ストアに通知されません。必要に応じて、Tranzila ボタンを使わずに WooCommerce で手動返金を作成してください。

ライセンスキー

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

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

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

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

トラブルシューティング

Tranzila does not appear at checkout：ライセンスが有効であること、Enable/Disable が有効であること、Terminal name (supplier) が入力されていること、ストアの通貨（Pay for order ページでは注文の通貨）が ILS、USD、EUR、GBP のいずれかであることを確認してください。端末名が未入力の場合や通貨がサポートされていない場合、設定ページに警告が表示されます。

The payment went through, but the order stays Pending payment：通知が届かなかったか、拒否されました。Notifications が有効であること、Trusted IP に Tranzila が通知を送信するアドレスが含まれていることを確認してください。エラーは常に WooCommerce > Status > Logs に、ソース wcp_tranzila_payment_gateway として記録されます。IP が Trusted IP リストにないという メッセージは、Trusted IP の設定またはプロキシの構成を修正する必要があることを意味します。プロキシや CDN の背後では、Web サーバーが実際の訪問者の IP アドレスを PHP に渡す必要があります。

Notification answers Forbidden：通知は Trusted IP にない IP アドレスから届きました。

Notification answers Bad request or Not found：通知内の注文、注文キー、端末、または取引インデックスが、このストアのどの注文とも一致しません。

Notification answers Accepted for manual review：Trusted IP が空のため、通知を検証できませんでした。成功した支払いは注文を保留にします。支払いを自動で確定するには、Trusted IP に入力してください。

Notification answers Busy, retry：同じ時刻に別のリクエストが注文を処理していたため、通知は適用されませんでした。Tranzila の端末で支払いを確認してください。注文がまだ支払い待ちで、支払いがそこで承認されている場合は、ステータスを手動で変更してください。

Some paid orders are On hold：注文メモを確認してください。金額、通貨、または handshake トークンが一致しなかったか、通知を検証できませんでした（Trusted IP が空、または通知が無効）。Tranzila の端末で支払いを確認し、ステータスを手動で変更してください。

The payment page does not open with the handshake on：端末名と端末パスワードを確認し、Tranzila の端末で handshake が有効になっていること、およびサーバーの IP アドレスがそこで許可されていることを確認してください。ログに理由が表示されます。

Refunds fail：返金には Terminal password (TranzilaPW) が必要です。端末によっては別のクレジットパスワードも必要です。その場合は Refund password (CreditPass) に入力してください。別の端末で支払われた注文は、その端末で返金する必要があります。

Other currencies：プラグインは ILS、USD、EUR、GBP に対応しています。開発者は tranzila_p_currency_map フィルターでこの一覧を変更できます。

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

アンインストール

プラグインを無効化してもすべてのデータは保持されます。完全に削除するには、無効化してから Plugins ページで削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。ゲートウェイの設定、注文に保存された Tranzila のデータ、プラグインのログ（ローテーションされたログファイルを含む）は、Delete data on uninstall が有効だった場合にのみ削除されます。それ以外の場合は、後で再インストールするために保持されます。既存の注文は、支払いメモと取引 ID を保持します。

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