VibeFox IntaSend for WooCommerce — ヘルプ

要件

WordPress: 6.2 以降。

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

PHP: 8.0 以降。

HTTPS: IntaSend は、本番決済とウェブフックに HTTPS を必要とします。本番モードが有効で、ストアのアドレスが HTTPS でない場合、設定ページに警告が表示されます。

IntaSend アカウント: IntaSend アカウントの公開キー（ISPubKey_...）と秘密キー（ISSecretKey_...）が必要です。サンドボックス用、本番用、またはその両方で構いません。また、IntaSend のダッシュボードでチャレンジフレーズ付きのウェブフックを設定する必要があります（設定を参照）。公開キーはチェックアウトを作成するために使用します。秘密キーは、支払いステータスを IntaSend に問い合わせるためにサーバー上でのみ使用します。

ストア通貨: KES、USD、EUR、GBP、UGX、TZS、NGN、GHS、XAF、XOF のいずれか。その他の通貨の場合、支払い方法は表示されません。

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

インストール

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

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

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

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

5. IntaSend のサンドボックスおよび/または本番のキーを貼り付け、IntaSend のダッシュボードでウェブフックを追加し、同じチャレンジフレーズをプラグインに入力します（設定を参照）。

6. Enable/Disable をオンにします。Test mode をオンにした状態で支払いをテストし、その後 Test mode のチェックを外して実際の支払いを受け付けます。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > IntaSend。フィールドの上には、ステータスボックスが Test mode: IntaSend sandbox, no real money is charged. または Live mode: real payments are accepted. と表示されます。また、現在のモードのキーが不足または誤っている場合（この場合、チェックアウトで支払い方法は表示されません）、ストア通貨がサポートされていない場合、ウェブフックのチャレンジが設定されていない場合、本番モードを HTTPS なしで使用している場合にも警告します。支払い方法の一覧では、現在のモードのキーが正しくなるまで、IntaSend に「要セットアップ」と表示されます。貼り付けたキーは、保存時に前後の空白が除去されます。

一般

Enable/Disable: Enable IntaSend で支払い方法のオン/オフを切り替えます。初期値: オフ。

Title: チェックアウトで購入者に表示される支払い方法の名前。初期値: IntaSend (M-Pesa, card)。

Description: チェックアウトで支払い方法の下に表示されるテキスト。初期値: You will be redirected to IntaSend to pay securely with M-Pesa, card or another available method.

API キー

キーは IntaSend のダッシュボードの Settings > API Keys で取得します。サンドボックス用ダッシュボードと本番用ダッシュボードで別々に取得してください。テストモードはサンドボックスのキーとサンドボックス API を使用し、本番モードは本番のキーと本番 API を使用します。プラグインは、公開キーが ISPubKey_ で始まること、秘密キーが ISSecretKey_ で始まること、キーが現在のモードに属していることを確認します。サンドボックスのキーには _test が、本番のキーには _live が含まれます。条件を満たさない場合、支払い方法は表示されず、ステータスボックスに理由が表示されます。

Test mode: Use the IntaSend sandbox (no real money is charged)。初期値: オン。チェックを外すと、本番のキーで実際の支払いを受け付けます。テストモードがオンの間、チェックアウトの支払い方法の下に TEST MODE - IntaSend sandbox, no real money is charged. と表示されます。

Sandbox publishable key: ISPubKey_test で始まります。チェックアウトの作成時に貴社を識別します。

Sandbox secret key: ISSecretKey_test で始まります。Payment Status API で支払いを確認するため、貴社のサーバーでのみ使用されます。

Live publishable key: ISPubKey_live で始まります。

Live secret key: ISSecretKey_live で始まります。支払いを確認するため、貴社のサーバーでのみ使用されます。

ウェブフック

ウェブフックは、購入者がストアに戻らない場合（ブラウザを閉じた、M-Pesa の確認が後になったなど）でも、支払いが行われたことをストアに通知します。IntaSend のダッシュボードで、サンドボックスと本番のそれぞれについて Webhooks を開き、この設定セクションに表示される URL を追加します。URL の形式は https://your-site/wc-api/intasend_pay/ です。そこにチャレンジフレーズを入力し、同じフレーズをプラグインにも入力します。サンドボックスと本番では同じチャレンジを使用してください。

Webhook challenge: IntaSend のダッシュボードと同じチャレンジです。別のチャレンジを使用したウェブフックは拒否されます。このフィールドが空の間、ウェブフックは処理されず、支払いは購入者がストアに戻ったときにのみ確認されます。このようなウェブフックにはエラーではなく Ignored と応答されるため、チャレンジを入力する前に IntaSend がウェブフックを無効にすることはありません。

プラグインは、IntaSend が報告する次の支払い状態に反応します。注文を変更する前には毎回、Payment Status API に問い合わせて実際の状態を確認します。

COMPLETE: 支払いが行われました。金額と通貨の確認後、注文は支払い済みになります。

FAILED or CANCELED: 支払いに失敗しました。注文がこの支払い試行をまだ待っている場合、注文は「失敗」になります。

PARTIAL: 請求書が一部だけ支払われました。注文は保留になります。

PENDING, PROCESSING or RETRY: 支払いはまだ処理中です。最終状態が届くまで、注文は変更されません。

支払いリンクや、同じ IntaSend アカウントでの送金イベントなど、このストアのチェックアウト支払いではない通知には OK と応答して無視します。これにより、IntaSend がウェブフックを無効にすることを防ぎます。

詳細設定

Debug log: Log checkout, return and webhook events。WooCommerce > Status > Logs のソース wcp_intasend_pay に記録されます。エラーは常に記録されます。API キーと購入者データは記録されません。初期値: オフ。

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted。注文に保存された IntaSend の参照情報は支払い履歴なので、常に保持されます。プラグインを無効化しても、何も削除されません。初期値: オフ。

チェックアウト

購入者は支払い方法（初期値は IntaSend (M-Pesa, card)）を選んで注文します。プラグインは注文金額を注文通貨で指定して IntaSend のチェックアウトを作成し、購入者を IntaSend がホストするチェックアウトページに移動させます。そこで購入者は、M-Pesa、カード、または貴社の IntaSend アカウントで有効になっているその他の方法で支払います。請求先のメールアドレス、氏名、住所、電話番号、国は、IntaSend のフィールドルールに適合する場合に IntaSend に渡されます。空欄または不適切なフィールドは除外されます。

支払い後、購入者はストアに戻ります。注文が支払い済みになるのは、IntaSend が確認した後だけです。プラグインは、購入者が戻ったときとウェブフックが届いたときに Payment Status API に問い合わせます。支払いがまだ確認されていない場合、注文受付ページには Your payment is being confirmed by IntaSend (M-Pesa confirmations can take a minute). You will receive an e-mail as soon as it is confirmed. が表示されます。注文が保留になった場合は、Your payment was received and your order is being reviewed. We will contact you if anything is needed. が表示されます。

支払いが失敗した場合、または購入者が支払わずに戻った場合、購入者はチェックアウト（または Pay for order ページ）に戻り、The payment was not successful. Please try again or choose another payment method.（IntaSend から理由が提供された場合はその理由も付きます）または The payment was not completed. Please try again or choose another payment method. というメッセージが表示されます。購入者は同じ注文の支払いをやり直せます。試行ごとに、それぞれ別の IntaSend 参照番号が割り当てられます。

IntaSend が支払いを開始できない場合、購入者には IntaSend could not start the payment: と IntaSend から提供された理由が表示されます。または IntaSend is temporarily unavailable. Please try again in a moment or choose another payment method. と表示されます。詳細はログに記録されます。

この支払い方法は、クラシックチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce High-Performance Order Storage（HPOS）に対応しています。

本プラグインは 1 回限りの決済のみに対応しています。返金は WooCommerce から IntaSend に送信されず、保存済みカード、定期購入、インライン（ポップアップ）決済フォームには対応していません。同じ注文の古いチェックアウトリンクは、IntaSend でキャンセルできません。

注文

注文ステータス

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

Processing or Completed: 支払いが確認されました。WooCommerce は支払い済み注文の通常のステータスを設定します。注文メモには、IntaSend の請求書、IntaSend での支払い方法、金額、モード（サンドボックスまたは本番）、確認方法（ウェブフックまたは購入者の戻り）が表示されます。トランザクション ID は IntaSend の請求書 ID です。

On hold: IntaSend が注文合計と異なる金額または通貨、一部入金、または注文のキャンセル後に届いた支払いを報告しました。注文メモに理由が記載されています。IntaSend のダッシュボードで支払いを確認し、注文を処理するか、支払いを返金してください。

Failed: 最新の支払い試行が失敗しました。メモには IntaSend の理由が表示されます。購入者は再試行できます。

支払い済みの注文に 2 回目の支払いが届いた場合、その注文は再び変更されません。重複した支払いであれば、IntaSend のダッシュボードで返金するよう、メモで通知されます。返金済みの注文に対する支払いはメモが追加されるだけで、注文は再び開かれません。

返金

返金は WooCommerce から IntaSend に送信されません。IntaSend のダッシュボードで支払いを返金し、WooCommerce で返金を手動で記録してください。

ライセンスキー

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

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

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

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

トラブルシューティング

チェックアウトに IntaSend が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードのキーが入力されていて、そのモードに属していることを確認してください。テストモードではサンドボックスのキー（_test を含む）、本番モードでは本番のキー（_live を含む）が必要です。ストア通貨はサポートされている必要があります。設定ページ上部のステータスボックスに問題が表示されます。

支払いは完了したが、注文が Pending payment のまま: M-Pesa の確認には少し時間がかかることがあります。IntaSend が最終状態を報告すると、ウェブフックが注文を確認します。IntaSend のダッシュボードにあるウェブフックの URL（使用しているサンドボックスまたは本番）が設定に表示されているものと完全に一致していること、そこのチャレンジが Webhook challenge と同じであることを確認してください。

ウェブフックが Ignored: webhook challenge not configured と応答する: Webhook challenge が空です。IntaSend のダッシュボードからチャレンジを入力してください。

ウェブフックが Invalid challenge と応答する: IntaSend とプラグインのチャレンジが一致しません。

ウェブフックが Verification unavailable, retry later または Busy, retry later と応答する: その時点で IntaSend に接続できなかったか、注文が別のリクエストで確認中でした。IntaSend はウェブフックを再送します。

ウェブフックが Invoice not verified または Invoice does not match the reference と応答する: IntaSend は、この請求書が注文に属することを確認できませんでした。注文は変更されません。

注文が On hold になっている: 注文メモを確認してください。支払われた金額または通貨が注文と異なった、支払いが一部だった、またはキャンセル後に届いた可能性があります。IntaSend のダッシュボードで支払いを確認してください。

注文時に購入者にエラーが表示される: Debug log をオンにして、WooCommerce > Status > Logs のソース wcp_intasend_pay を確認してください。注文合計は 0 より大きい必要があります。ログに、戻り URL に IntaSend が受け付けない文字が含まれると記録されている場合、原因はストアのアドレスまたはその中の言語パラメータです。

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

アンインストール

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

IntaSend は各所有者の商標です。本プラグインは IntaSend と提携しておらず、IntaSend による推奨もされていません。