VibeFox Niubiz for WooCommerce — ヘルプ

要件

WordPress: 5.8 以降。

WooCommerce: 6.0 以降。インストール済みかつ有効化されていること。WooCommerce がないとプラグインは有効化できません。

PHP: 8.0 以降。

ストアの通貨: ペルー・ソル（PEN）または米ドル（USD）。その他の通貨の場合、チェックアウトで支払い方法は表示されません。

Niubiz アカウント: Niubiz は環境ごとに merchant ID（código de comercio）、API user、API password を発行します。サンドボックスの認証情報は Niubiz の連携チームから、本番の認証情報は Niubiz が連携を認定した後に提供されます。Webhook を設定する必要はありません。Niubiz は承認にすぐ応答します。

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

インストール

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

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

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

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

5. Sandbox mode をオンのままにして、サンドボックスの merchant ID、API user、API password を入力します（設定の項を参照）。

6. Enable/Disable をオンにして、Niubiz のテストカードでいくつかテスト決済を行います。

7. Niubiz が連携を認定したら、本番の認証情報を入力し、Sandbox mode のチェックを外します。

設定

すべての設定は 1 つのページにあります：WooCommerce > Settings > Payments > Niubiz。フィールドの上には、ストアの通貨が PEN や USD でない場合、または現在のモードの認証情報が不完全な場合に警告が表示されます（どちらの場合も、チェックアウトで支払い方法は非表示になります）。サンドボックスモードがオンの間は サンドボックスモードがオンです：決済は Niubiz のサンドボックスに送信され、実際の請求は行われません。 と表示されます。支払い方法の一覧では、現在のモードの認証情報がそろうまで、Niubiz に設定が必要と表示されます。

一般

Enable/Disable: Enable Niubiz payments は、支払い方法のオン／オフを切り替えます。既定値：オフ。

Title: チェックアウトで購入者に表示される支払い方法の名称。既定値：Credit or debit card (Niubiz)。

Description: チェックアウトで支払い方法の下に表示されるテキスト。既定値：Pay securely with Visa, Mastercard, American Express or Diners Club in the Niubiz payment form.

Niubiz 認証情報

Niubiz は、サンドボックス用に、また認定後は本番用に、merchant ID、API user、API password を提供します。開発者向けドキュメントは desarrolladores.niubiz.com.pe にあります。

Sandbox mode: Use the Niubiz sandbox (QA) environment — no real charges。API のエンドポイントと、下記の認証情報の両方を切り替えます。既定値：オン。実際の決済を受け付けるにはチェックを外します。

Sandbox merchant ID: サンドボックスアカウントの加盟店コード。数字のみ。スペースは削除されます。値に他の文字が含まれている場合、設定ページにエラーが表示され、以前の値が保持されます。

Sandbox API user: サンドボックスの API user。

Sandbox API password: サンドボックスの API password。

Production merchant ID: 本番（提携）アカウントの加盟店コード。数字のみ。

Production API user: 本番の API user。

Production API password: 本番の API password。

決済フォーム

Logo URL: 任意です。Niubiz の決済フォームに表示するロゴの HTTPS アドレス（約 187 × 40 px）。未設定の場合はストア名が表示されます。https:// で始まらないアドレスは拒否され、以前の値が保持されます。

詳細設定

Debug log: Log API calls は、Niubiz へのリクエストを WooCommerce > Status > Logs に、ソース wcp_niubiz_payment として書き込みます。エラーは常に記録されます。認証情報、トークン、カードや購入者のデータは一切記録されません。既定値：オフ。

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted。無効化しても何も削除されません。注文に保存された決済データは保持されます。既定値：オフ。

認証情報が 1 組だけだったバージョン 1.0 の設定は自動的に移行されます。テストモードがオンだった場合はサンドボックスの項目へ、それ以外の場合は本番の項目へ移行されます。

チェックアウト

購入者は支払い方法（既定では Credit or debit card (Niubiz)）を選択して注文します。プラグインは注文合計に対する Niubiz のアクセストークンと決済セッションを要求し、購入者をストアの注文決済ページに移動させます。サンドボックスモードでは、チェックアウトと決済ページに サンドボックスモード：Niubiz のテストカードを使用してください。実際の請求は行われません。 と表示されます。

決済ページでは Niubiz の決済フォームが自動的に開きます。ページには、フォームを再度開くための注文合計付きの Pay ボタン、Cancel order ボタン、Choose another payment method のリンクもあります。JavaScript が必要です。Niubiz のフォームを読み込めない場合は、Niubiz の決済フォームを読み込めませんでした。ページを再読み込みするか、しばらくしてから再度お試しください。 と表示されます。

購入者は Niubiz のフォームにカード情報を入力します。Niubiz はストアに 1 回限りのトークンを返し、プラグインは注文自体の金額、通貨、購入番号を使用してサーバー上で承認を行います。決済はすぐに請求されます。注文が支払い済みになるのは、Niubiz が決済を承認し、その応答が注文と一致した場合だけです。その後、購入者は注文受付ページを表示されます。

カードが拒否された場合: 購入者は Your payment was declined: と Niubiz からの理由を表示した決済ページに戻り、同じカードまたは別のカードで再試行できます。フォームはメッセージの上に再度開きません。購入者は Pay をクリックします。

Niubiz からの応答がない場合: Niubiz が確定的な結果を返さない場合（タイムアウト、サーバーエラー、読み取れない応答）、購入者には Niubiz での決済を確認できませんでした。再度お支払いいただかないでください。ストアが決済を確認し、ご連絡します。 と表示された注文受付ページが表示されます。

セッションの期限切れ: 決済セッションの有効期間は最長 20 分です。セッションが使用されたとき、または期限が近いとき、あるいは注文合計やモードが変わったときは、決済ページが新しいセッションを作成します。

決済を試行するたびに新しい購入番号が発行されます。注文 ID に 3 桁の試行番号を続けた形式（最大 12 文字）です。Niubiz は承認ごとに一意の購入番号を要求するためです。購入者は Pay for order ページから、未払いまたは失敗した注文を再度支払うことができます。

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

プラグインは 1 回限りのカード決済のみに対応しています。WooCommerce からの返金やキャンセルには対応していません。保存済みカード、サブスクリプションや定期決済、分割払い（cuotas）の選択、PagoEfectivo、Yape、その他のウォレットや QR 決済にも対応していません。応答が失われたために保留になった注文は、自動では再確認されません。

注文

注文ステータス

支払い待ち: 購入者は決済ページに移動しましたが、まだ支払っていません。

処理中: Niubiz が決済を承認し、応答が注文と一致しました。ダウンロード可能な仮想商品のみの注文は、WooCommerce の通常の動作どおり完了になります。注文メモには、環境、トランザクション ID、承認コード、購入番号、マスクされたカード番号付きのカードブランドが表示されます。注文のトランザクション ID は Niubiz のトランザクション ID です。

失敗: カードが拒否されました。注文メモには、Niubiz の理由、アクションコード、購入番号が表示されます。購入者は再度支払うことができます。

保留（承認済みだが一致しない）: Niubiz は、購入番号、金額、通貨のいずれかが注文と異なる決済、または応答に金額や通貨が含まれない決済を承認しました。注文は支払い済みになりません。メモに相違点が一覧表示されます。Niubiz の管理画面でトランザクションを確認してください。購入者には お支払いを受け付け、ストアで確認中です。 と表示されます。

保留（確定的な結果なし）: Niubiz が明確な応答を返さなかったため、カードに請求された可能性があります。メモには購入番号が記載されます。Niubiz の管理画面で検索してください。トランザクションが承認され正しければ、注文を処理中に設定します。そうでなければキャンセルします。

キャンセル: 購入者が決済ページで Cancel order をクリックした、またはあなたや WooCommerce の在庫保持タイムアウトによって注文がキャンセルされました。

Niubiz がリクエスト自体を拒否した場合（例: 購入番号の重複、HTTP 406、無効な認証情報）、注文のステータスは変わりません。メモにはカードが請求されていないことが記載され、購入者は新しい購入番号で再試行できます。

返金

返金およびキャンセルは WooCommerce からは行えません。Niubiz の管理画面でトランザクションを返金またはキャンセルし、WooCommerce の手動返金など、注文を手動で更新してください。

ライセンスキー

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

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

有効なキーがない場合、Niubiz はチェックアウトで購入者に表示されません。それでも決済が開始された場合、購入者には この支払い方法は利用できません。別の方法をお選びください。 と表示されます。ログイン中のストア管理者には、(unlicensed — visible to admins only) と表示された状態で支払い方法が表示されるため、キーを購入する前にプラグインを設定してテストできます。プラグインのページと WooCommerce のページには通知が表示されます。既存の注文には影響しません。Niubiz フォームで既に開始された決済は引き続き承認されます。

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

トラブルシューティング

チェックアウトに Niubiz が表示されない: ライセンスが有効であること、Enable/Disable がオンであること、現在のモードの merchant ID、API user、API password が入力されていること（サンドボックスモードではサンドボックスの項目、それ以外では本番の項目）、通貨が PEN または USD であることを確認してください。Pay for order ページでは注文の通貨が対象になります。認証情報や通貨が正しくない場合、設定ページに警告が表示されます。

決済は完了したが、注文が支払い待ちのまま: Niubiz はこの決済フォームに Webhook を提供していないため、注文は承認の応答によってのみ更新されます。注文がメモ付きの保留になっている場合は、Niubiz の管理画面で購入番号を検索してください。注文が支払い待ちのままの場合は、購入者がフォームを完了していません。WooCommerce > Status > Logs（ソース wcp_niubiz_payment）を確認してください。

購入者に「Niubiz に接続できませんでした」と表示される: アクセストークンを取得できませんでした。現在のモードの API user と API password を確認し、サーバーから Niubiz API に接続できるかを確認してください。詳細は Debug log を有効にして確認できます。

購入者に「Niubiz での決済を開始できませんでした」と表示される: Niubiz が決済セッションを作成しませんでした。現在のモードの merchant ID とログを確認してください。

購入者に「この決済の試行は既に処理されています」と表示される: 同じフォームが 2 回送信されました。購入者は決済ページで決済をやり直します。カードは二重に請求されません。

購入者に「決済セッションが期限切れになりました。カードには請求されていません」と表示される: 決済ページが長時間開かれたままでした。購入者は同じページで再度お試しください。

注文メモ「Niubiz が重複した承認を報告しました」: Niubiz は既にこの購入番号を認識しています。Niubiz の管理画面で確認してください。購入者は新しい購入番号で再試行できます。

注文が Niubiz のメモ付きで保留になっている: メモを確認してください。Niubiz が確定的な結果を返さなかったか、注文と一致しない決済を承認しました。Niubiz の管理画面で購入番号を検索し、注文を処理中に設定するかキャンセルしてください。

設定の保存時にエラーが表示される: merchant ID は数字のみで構成する必要があり、ロゴの URL は有効な https:// アドレスである必要があります。以前の値が保持されます。

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

開発者向け: Niubiz から加盟店固有の不正対策フィールド（MDD）の送信を求められた場合は、niubiz_p_merchant_define_data フィルターで追加できます。キーは MDD に番号を付けたもので、値は 100 文字以内です。その他のフィルター: niubiz_p_cardholder_data（決済セッションとともに送信されるカード保有者データ）、niubiz_p_purchase_number（試行ごとの購入番号。1 〜 12 文字の英字または数字で、試行ごとに一意）、niubiz_p_icon（支払い方法のアイコン）。

アンインストール

プラグインを無効化しても、すべてのデータは保持されます。削除するには、Plugins ページで無効化してから削除してください。このプラグインのライセンスキーとライセンスステータスは、常に削除されます。ゲートウェイの設定とログは、Delete data on uninstall がオンになっている場合にのみ削除されます。注文に保存された Niubiz のデータ（トランザクション ID、購入番号、マスクされたカード）は決済履歴であるため、常に保持されます。既存の注文は、支払いのメモとトランザクション ID を保持します。

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