概要
VibeFox Niubiz Payment は、Niubiz の公式決済フォーム（Botón de pago web）によるペルーでのカード決済を PrestaShop に追加します。支払いステップで購入者が Niubiz を選ぶと、ストアの支払いページに移動し、そこで Niubiz のフォームが開きます。購入者は Niubiz のフォームにカード情報を入力し、ストアがサーバー上で決済を承認します。カード情報がストアのサイトを経由することはありません。注文は Niubiz から応答を受け取った後にのみ作成されるため、途中で離脱した決済や拒否された決済によって未払いの注文が残ることはありません。
PEN（ペルー・ソル）または USD（米ドル）で販売し、Niubiz の加盟店契約を持つペルーのストアに適しています。本モジュールは 1 回限りのカード決済のみに対応しています。PrestaShop からの返金やキャンセルには対応しておらず、保存済みカード、サブスクリプション、分割払い（cuotas）、PagoEfectivo、Yape、QR 決済にも対応していません。
主な機能
Niubiz 決済フォーム: Niubiz の加盟店契約で受け付けているカードブランドに応じて、Visa、Mastercard、American Express、Diners Club に対応します。フォームにはストア名または独自のロゴが表示されます。
Niubiz が承認した場合にのみ支払い済みとなります: 注文が Payment accepted になるのは、Niubiz が承認を行い、その応答がカート（購入番号、金額、通貨）と一致した場合だけです。一致しない場合、注文はメモ付きで Niubiz payment on hold になります。
応答が届かなくても安全: Niubiz からのタイムアウトや読み取れない応答があった場合、確認が必要な購入番号とともに Niubiz payment on hold の注文が作成され、購入者には再度支払わないよう案内されます。
カードが拒否された場合: 注文は作成されません。購入者は支払いページで Niubiz からの理由を確認でき、別のカードですぐに再試行できます。各試行には新しい購入番号が割り当てられます。
二重処理なし: フォームの繰り返しや並行送信によって、承認が二度行われることはなく、2 つ目の注文が作成されることもありません。フォームを開いた後にカートが変更された場合、カードには請求されません。
サンドボックスと本番: 環境ごとに別々の認証情報を使用します。サンドボックスモードでは、API のエンドポイントと認証情報の両方が切り替わり、進行中の決済は開始された環境のまま保たれます。
注文ページの Niubiz ブロック: 購入番号、環境、トランザクション ID、承認コード、マスク済みのカード情報、注文の Niubiz メモ。認証情報、トークン、カードや購入者のデータを含まない、任意のログを記録できます。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。カートの通貨は PEN または USD。Niubiz のサンドボックスと本番の認証情報（merchant ID、API user、API password）。Webhook は不要です。vibefox.net で取得した VibeFox ライセンスキー（1 つのキーは 1 つのドメインで使用可能）。