VibeFox Khipu for WooCommerce — ヘルプ

要件

WordPress: 6.0 以降。

WooCommerce: 8.0 以降がインストールされ、有効になっていること。WooCommerce がないと、プラグインは有効化を拒否します。

PHP: 8.0 以降。

ストアの通貨: チリペソ (CLP)、アルゼンチンペソ (ARS)、またはペルーソル (PEN)。ストア、または Pay for order ページの注文が別の通貨を使用している場合、この支払い方法はチェックアウトで表示されません。

Khipu アカウント: Khipu の集金アカウントの Receiver ID (「Id de cobrador」)、API キー、シークレットキー (「llave」) が必要です。これらは Khipu アカウントの加盟店プロフィール (khipu.com/merchant/profile) で確認できます。3 つすべてが必須です。シークレットキーがないと支払いを確認できません。

インターネットから到達可能なサイト: Khipu はストアを呼び出して支払いを確認するため、サイトがインターネットから到達可能である必要があります (メンテナンスモード、Basic 認証、Khipu をブロックするファイアウォールがないこと)。

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

インストール

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

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

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

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

5. Khipu の集金アカウントの Receiver ID、API key、Secret key を入力します (「設定」を参照してください)。

6. Enable / Disable をオンにして保存します。まずテストする場合は、Khipu の開発者アカウントのキーを使用し、その後で本番アカウントのキーに置き換えてください。

設定

すべての設定は 1 つのページにあります: WooCommerce > Settings > Payments > Khipu。フィールドの上には、Receiver ID、API キー、シークレットキーが入力されていない場合 (この場合 Khipu はチェックアウトで表示されません) と、ストアの通貨がサポートされていない場合に警告が表示されます。支払い方法の一覧では、3 つのキーがすべて入力されるまで、Khipu はセットアップが必要な状態として表示されます。

一般

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

Title: 購入者がチェックアウトで目にする支払い方法の名前。既定値: Khipu。

Description: チェックアウトで支払い方法の下に表示されるテキスト。既定値: Pay by bank transfer with Khipu。

Khipu アカウント

Receiver ID、API キー、シークレットキーを Khipu の集金アカウント (khipu.com/merchant/profile) からコピーします。Khipu には別のサンドボックスサーバーはなく、プラグインにもテストモードの切り替えはありません。テストするには、開発者 (「desarrollo」) の集金アカウントのキーを使用します。このアカウントは DemoBank のテストバンクで支払いを行い、実際のお金は動きません。公開時には本番の集金アカウントのキーに切り替えてください。

Receiver ID: Khipu の Receiver (「cobrador」) ID です。他の Khipu アカウントの支払いは拒否されます。

API key: 支払いの作成と、Khipu での各支払いの検証に使用します。

Secret key: Khipu の支払い通知の署名 (HMAC-SHA256) の検証に使用します。これがないと支払いを確認できません。

支払い通知

Khipu は、設定のこのセクションに表示される通知 URL を呼び出して支払いを確認します。URL は https://your-site/wc-api/webhook_wc_khipu/ のような形式です。URL は各支払いとともに自動的に送信されるため、Khipu アカウント側で設定する必要はありませんが、URL はインターネットから到達可能である必要があります。

各通知には、Secret key で作成された有効な署名が必要です。有効な署名のない通知は拒否されます。その後、プラグインは Khipu に支払い状況を問い合わせ、Khipu が報告した内容に基づいて処理します:

done: 送金が確認されました。Receiver ID、注文、金額のチェック後に、注文は支払い済みになります。

done, reversed: 支払いが取り消されました。未払いの注文は支払い済みになりません。支払い済みの注文にはメモが追加され、ステータスは変更されません。

pending or verifying: 送金がまだ確定していません。プラグインは「後で再試行」と応答し、Khipu は通知を再送します。

Status after payment: Khipu が支払いを確認した後の注文ステータスです。ステータスはすぐに設定され、ステータス変更 1 回とメール送信 1 回だけが行われます。

Processing: WooCommerce に判断を任せます (既定値)。バーチャルでダウンロード可能な注文は自動的に完了になります。

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

詳細設定

Debug log: Log API calls and notifications で、WooCommerce > Status > Logs にソース wcp_khipu_gateway として API 呼び出しと通知を記録します。エラーは常に記録されます。キーと支払者データが書き込まれることはありません。既定値: オフ。

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted をオンにすると、プラグインを削除したときにゲートウェイの設定とログが削除されます。注文データ (注文内の Khipu 支払い ID) は常に保持されます。既定値: オフ。

チェックアウト

購入者は支払い方法 (既定では Khipu) を選択して注文します。プラグインは、注文番号、ストア名、注文された商品とともに、注文通貨での注文合計に対する Khipu 支払いを作成し、購入者を Khipu の支払いページへ送ります。請求先メールアドレスは、有効な場合に Khipu へ渡されます。Khipu のページで、購入者は自分の銀行から銀行振込で支払い、そこで Khipu が提供する振込タイプを選択します。

支払い後、購入者はストアの注文受付ページに戻ります。注文が支払い済みになるのは、Khipu が送金を確認した後だけです。確認は、署名付き通知、または購入者が注文受付ページを開いたときの Khipu へのステータス問い合わせによって行われます。戻ってきたこと自体で注文が支払い済みになることはありません。送金が確認されるまでの間、ページには Khipu is confirming your bank transfer. Your order will be updated automatically as soon as Khipu confirms the payment, and you will receive an e-mail. と表示されます。

購入者が支払わずに Khipu のページを離れた場合、購入者は Pay for order ページに移動し、The Khipu payment was not completed. You can try again or choose another payment method. と表示されます。新たに試すと以前の未払いの Khipu 支払いが削除されるため、古いリンクでは支払えなくなります。Khipu が以前の支払いをすでに受け取っていた場合は、注文は完了となり、新しい支払いは作成されません。以前の送金がまだ確認中の場合、購入者には Your previous Khipu payment for this order is still being verified by the bank. Please wait a few minutes before paying again. と表示されます。

在庫管理がオンの場合、Khipu の支払いは WooCommerce の Hold stock (minutes) の時間とともに失効するため、購入者はすでにキャンセルされた注文を支払うことはできません。

Khipu が支払いを作成できない場合、購入者には短いメッセージが表示されます。たとえば Khipu could not create the payment for this order. Please check your billing details and try again, or contact the store. や Khipu is temporarily unavailable. Please try again in a few minutes. です。詳細はログに記録されます。

この支払い方法は、クラシックなチェックアウト、チェックアウトブロック、Pay for order ページで動作します。WooCommerce の高性能注文ストレージ (HPOS) と互換性があります。

このプラグインは 1 回限りの銀行振込の支払いのみを扱います。WooCommerce からの返金には対応しておらず、サブスクリプション、保存された支払い方法、事前承認もありません。

注文

注文ステータス

Pending payment: 購入者が Khipu へ送られ、まだ支払っていないか、Khipu がまだ送金を確認していない状態です。注文メモには Khipu 支払い ID が表示されます。

Processing or Completed: Khipu が支払いを確認しました。ステータスは Status after payment に従います。注文メモには Khipu 支払い ID が表示され、取引 ID は Khipu 支払い ID になります。

On hold: Khipu が報告した支払いの金額または通貨が注文と一致しないか、注文がキャンセルされた後 (たとえば在庫保持時間の経過後) に支払いが届いた状態です。注文メモにその内容が記載されます。Khipu アカウントで支払いを確認し、注文を完了するか購入者に返金してください。

すでに支払い済みの注文、または支払い後にクローズされた注文に対して支払いが届いた場合、注文は変更されません。2 回目の支払いである場合は、購入者に返金するよう求めるメモが追加されます。

返金

返金は WooCommerce から Khipu へ送信されません。Khipu アカウントまたは銀行振込で購入者に返金し、その後で WooCommerce に手動で返金を記録してください。

ライセンスキー

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

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

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

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

トラブルシューティング

Khipu がチェックアウトに表示されない: ライセンスが有効であること、Enable / Disable がオンであること、Receiver ID、API key、Secret key がすべて入力されていることを確認してください。ストアの通貨は CLP、ARS、PEN のいずれかである必要があります。何か不足していると、設定ページに警告が表示されます。

支払いは完了したのに、注文が Pending payment のまま: Khipu は銀行が確認した後に送金を確定します。注文は、Khipu の通知が届いたとき、または購入者が注文受付ページを開いたときに更新されます。設定に表示される通知 URL でサイトがインターネットから到達可能であること (メンテナンスモード、Basic 認証、Khipu をブロックするファイアウォールがないこと) を確認し、WooCommerce > Status > Logs のソース wcp_khipu_gateway を確認してください。

通知が Secret key not configured と応答する: Secret key が空です。入力してください。Khipu は通知を再送します。

通知が Invalid signature、Missing signature、Malformed signature と応答する: Secret key が、使用しているキーの集金アカウントのものではないか、リクエストが Khipu からのものではありません。

通知が Payment does not belong to this order と応答する: 支払いが別の Receiver ID に対して、または別の注文に対して行われています。Receiver ID を確認してください。

通知が Payment not final yet または Verification unavailable と応答する: 送金がまだ確認中であるか、Khipu に接続できませんでした。Khipu は通知を再送します。

注文が On hold になっている: 注文メモを確認してください。金額または通貨が注文と一致しなかったか、注文がキャンセルされた後に支払いが届いています。

購入者に「Khipu payments are not available right now」と表示される: API キーが不足しているか、正しくありません。Khipu アカウントのキーを確認してください。

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

Khipu アカウントが別の通貨 (たとえば Khipu Spain の EUR) を受け入れる場合、開発者はフィルター wc_khp_supported_currencies で追加できます。

アンインストール

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

Khipu はそれぞれの所有者の商標です。このプラグインは Khipu と提携しておらず、Khipu の承認も受けていません。