VibeFox iPay88 for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

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

PHP: 8.0 以降。

iPay88 加盟店アカウント: Merchant Code と Merchant Key は、加盟店アカウントが有効化された時点で iPay88 から発行されます。iPay88 加盟店ポータルにも表示されます。まだ加盟店でない場合は、iPay88 の Web サイトで申し込んでください。Merchant Key は秘密にしてください。支払いの署名に使われます。

Request URL: 貴店の Web サイトのアドレスが、iPay88 にリクエスト URL として登録されている必要があります。登録されていない場合、iPay88 のページに "Permission not allow" と表示されます。

ストアの通貨: Malaysia — MYR。iPay88 アカウントで多通貨オプションが有効な場合は、USD、SGD、AUD、CAD、EUR、GBP、HKD、CNY、TWD、INR、IDR、PHP、THB も利用できます。Philippines — PHP または USD。Indonesia — IDR。Thailand — THB。

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

インストール

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

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

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

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

5. iPay88 region を選択し、Merchant Code と Merchant Key を入力します（設定の項を参照）。

6. Enable/Disable をオンにします。セットアップを確認するには、Test mode をオンにした状態で支払いを行い、その後テストモードをオフにします。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > iPay88。入力欄の上部には、Merchant Code または Merchant Key が未入力の場合（その場合、支払い方法はチェックアウトに表示されません）、ストアの通貨を選択した地域で請求できない場合、テストモードがオンの間に警告が表示されます。支払い方法の一覧では、両方のキーが入力されるまで iPay88 に「設定が必要」と表示され、テストモードがオンの間はテストモードのバッジが表示されます。

一般

Enable/Disable: Enable iPay88 Payment Gateway で支払い方法をオンまたはオフにします。デフォルト: オフ。

Title: チェックアウトで購入者に表示される支払い方法の名前です。デフォルト: iPay88。

Description: チェックアウトで支払い方法の下に表示されるテキストです。デフォルト: Pay securely via iPay88 (credit card, online banking, e-wallet)。

iPay88 アカウント

iPay88 region: iPay88 加盟店アカウントの国です。iPay88 の決済ページと、請求可能な通貨を決定します。注文は常に各通貨で請求されます。デフォルト: Malaysia。

Malaysia (payment.ipay88.com.my): MYR、およびアカウントで多通貨が有効な場合は要件に記載されているその他の通貨。

Philippines (payment.ipay88.com.ph): PHP、USD。

Indonesia (payment.ipay88.co.id): IDR。小数点なしで送信されます。

Thailand (payment.ipay88.co.th): THB。

Merchant Code: iPay88 の Merchant Code です。例: M01234。

Merchant Key: iPay88 の Merchant Key です。支払い要求に署名し、iPay88 からの応答を検証します。秘密にしてください。

Signature type: 支払い要求の署名方式です。応答は両方の形式で検証されます。

SHA256 (recommended): 現行の iPay88 仕様です（デフォルト）。

SHA1 (legacy): iPay88 から従来の署名を使うよう求められた場合にのみ選択してください。

支払い

Payment method: マレーシアの PaymentId 一覧から iPay88 の支払い方法を 1 つ事前に選択するか、Let the customer choose on the iPay88 page（デフォルト）のままにします。一覧には Credit Card (MYR)、FPX (Online Banking)、Maybank2U、Alliance Online、AmBank、RHB Bank、Hong Leong Bank、CIMB Clicks、Web Cash、PayPal (MYR)、Credit Card (PHP)、Boost、Touch n Go eWallet、GrabPay、ShopeePay が含まれます。

Reference prefix: 任意です。iPay88 の参照番号（RefNo）で注文番号の前に付加されます。例: SHOP1-。同じ iPay88 アカウントを使用するストアごとに異なるプレフィックスを設定してください。そうすると、あるストアの応答が別のストアの注文に適用されることはありません。使用できるのは英数字、「-」、「_」で、最大 10 文字です。末尾が数字のプレフィックスは、注文番号が参照番号の末尾から読み取られるため、保存時に修正されます。

Test mode: Charge a fixed test amount instead of the order total。iPay88 には独立したサンドボックスがありません。テスト支払いは、iPay88 の本番決済ページ上で少額（1.00、IDR 10,000）で行われる実際の取引です。テスト金額を受け取ると注文は支払い済みとしてマークされ、注文メモにその旨が記載されます。テストモードがオンの間、チェックアウトには TEST MODE: only a test amount of ... will be charged. と表示されます。本番のストアではテストモードを絶対にオンのままにしないでください。デフォルト: オフ。

応答 URL と backend URL

プラグインは支払いごとに両方の URL を送信するため、設定は不要です。iPay88 から要求された場合は、設定のこのセクションからコピーしてください。形式は次のとおりです: https://your-site/wc-api/ipay88_p_response/（Response URL、購入者の戻り）と https://your-site/wc-api/ipay88_p_backend/（Backend URL、サーバー間の通知）。このセクションには、iPay88 にリクエスト URL として登録する必要がある貴店の Web サイトのアドレスも表示されます。

iPay88 の両方の応答は同じ方法で確認されます。Merchant Key で作成された署名、このストアがこの注文のために開始した支払いの参照番号、金額、通貨です。有効な署名のないリクエストは拒否され、注文が変更されることはありません。backend 通知は処理後にのみ RECEIVEOK で応答されます。そうしないと iPay88 が再送します。iPay88 は次の支払い状況を報告します:

1（成功）: 支払いが完了しました。金額と通貨の確認後、注文は支払い済みとしてマークされます。

6（保留）: ATM または仮想口座への振込など、支払いはまだ待機中です。iPay88 が確認または失敗と判定するまで、注文は保留になります。

その他の状況: 支払いに失敗したか、キャンセルされました。注文は iPay88 の理由とともに「失敗」になります。

詳細設定

Debug log: WooCommerce > Status > Logs、ソース wcp_ipay88_payment で Log payment requests and iPay88 responses を記録します。個人データや署名は含まれません。エラーは常に記録されます。デフォルト: オフ。

Delete data on uninstall: Delete the settings, logs and iPay88 order data when the plugin is deleted。注文そのものが削除されることはありません。デフォルト: オフ。

チェックアウト

購入者は支払い方法（デフォルトは iPay88）を選び、注文します。注文は Pending payment のままになり、貴店の地域の iPay88 決済ページにフォームが送信されている間、購入者には Redirecting to iPay88 payment gateway... と表示されます。JavaScript が無効な場合、購入者は Pay Now をクリックします。注文商品、購入者の名前、メールアドレス、電話番号は iPay88 に渡されます。iPay88 のページで、購入者はカード、FPX オンラインバンキング、電子ウォレット、またはアカウントで利用可能なその他の方法で支払います。

支払い後、購入者は貴店の注文受付ページに戻ります。注文は、購入者の戻り時、または backend 通知のいずれかで、iPay88 が署名付きの応答によって支払いを確認した後にのみ支払い済みとしてマークされます。確認がまだ届いていない場合、ページには We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. と表示されます。保留中の支払いの場合は Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed. と表示されます。

支払いが失敗またはキャンセルされた場合、購入者は Pay for order ページに移動し、The payment was not completed: と iPay88 の理由が表示されます。購入者は再度支払うか、別の支払い方法を選択できます。応答を検証できない場合、購入者には The payment response could not be verified. If you completed the payment, please contact us with your order number — the payment will be checked manually. と、ストアに戻るリンクが表示されます。

在庫は、購入者がリダイレクトされたときではなく、支払いが確認されたときに減算されます。この支払い方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce の高性能注文保存（HPOS）に対応しています。

本プラグインは 1 回限りの支払いのみに対応しています。WooCommerce からの返金、カードの保存、サブスクリプション、事前承認とキャプチャ、貴店サイト上のカード入力欄には対応していません。支払い状況を iPay88 に再照会することはありません。注文は iPay88 の応答と backend 通知によってのみ更新されます。iPay88 Indonesia API 2.0（JSON / 支払いリンク）は使用されません。

注文

Order statuses

Pending payment: 購入者は iPay88 に移動されたものの、まだ支払っていないか、iPay88 がまだ支払いを確認していない状態です。

Processing or Completed: 支払いが確認されました。WooCommerce は支払い済み注文に通常のステータスを設定します。注文メモには iPay88 の TransID、PaymentID、金額、通貨が表示されます。トランザクション ID は iPay88 の TransID です。テストモードでは、2 つ目のメモに、注文合計ではなくテスト金額が請求されたことが記載されます。

On hold, pending at iPay88: iPay88 が支払いを保留と報告しました。iPay88 が支払いを確認または失敗と判定すると、注文が更新されます。

On hold, for review: iPay88 が、注文と金額または通貨が異なる成功した支払いを報告したか、注文のキャンセル後に支払いが届きました。注文は支払い済みとしてマークされていません。注文メモに理由が記載されています。iPay88 ポータルで支払いを確認し、注文を処理するか、支払いを返金してください。

Failed: 支払いに失敗したか、キャンセルされました。メモには iPay88 の理由が表示されます。購入者は再度支払うことができます。

支払い済みまたは返金済みの注文に、別の成功した支払いが届いた場合、注文は変更されません。重複である場合は、iPay88 ポータルで確認して返金するようメモに記載されます。失敗の応答によって、支払い済み、返金済み、またはキャンセル済みの注文が変更されることはありません。

返金

返金は WooCommerce から iPay88 に送信されません。iPay88 加盟店ポータルで支払いを返金し、WooCommerce にも手動で返金を記録してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに iPay88 が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、Merchant Code と Merchant Key が入力されていること、そしてストアの通貨が選択した iPay88 region で請求可能であることを確認してください。設定ページには、不足している項目があると警告が表示されます。

支払いは完了したが、注文が Pending payment のまま: 購入者の戻りも backend 通知も、有効な署名付きで貴店に届いていません。Debug log をオンにし、WooCommerce > Status > Logs でソース wcp_ipay88_payment を確認してください。Merchant Key が iPay88 から提供されたものと完全に一致していること、また貴店のサイトが、設定に表示されている Backend URL で iPay88 からのリクエストを受信できることを確認してください。

iPay88 のページに "Permission not allow" と表示される: 貴店の Web サイトのアドレスが、iPay88 にリクエスト URL として登録されていません。Response and backend URLs のセクションに表示されているアドレスを登録するよう iPay88 に依頼してください。

Backend 通知が BAD SIGNATURE と応答する: 署名が Merchant Key と一致しません。Merchant Key を確認してください。

Backend 通知が NOT CONFIGURED と応答する: Merchant Code または Merchant Key が設定されていないため、応答を検証できません。iPay88 は通知を再送します。

Backend 通知が UNKNOWN ORDER と応答する: この参照番号では、このストアで iPay88 の支払いが開始されていません。たとえば、同じアカウントを使う別のストアが Reference prefix を設定していない、または同じプレフィックスを使っている可能性があります。

注文が On hold になり、金額または通貨に関するメモがある: iPay88 が注文と一致しない支払いを報告したか、注文がキャンセルされていました。注文は支払い済みとしてマークされていません。iPay88 ポータルで支払いを確認し、完了または返金してください。

購入者に "iPay88 cannot accept payments in" と通貨が表示される: 注文の通貨は、選択した地域で請求できません。iPay88 Malaysia では、MYR 以外の通貨には iPay88 アカウントで多通貨オプションを有効にする必要もあります。

実際の購入者が 1.00 だけ請求される: Test mode がオンになっています。オフにしてください。

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

開発者は、フィルター ipay88_p_payment_url、ipay88_p_supported_currencies、ipay88_p_currency_decimals、ipay88_p_test_amount、ipay88_p_icon を使って、決済ページの URL、通貨、小数点以下の桁数、テスト金額、アイコンを変更できます。

アンインストール

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

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