概要
VibeFox KOMOJU Payment は PrestaShop に KOMOJU 決済を追加します。決済ステップで購入者が KOMOJU を選ぶと、KOMOJU がホストする決済ページに移動し、そこでクレジットカードまたはデビットカード、コンビニ払い（konbini）、PayPay、銀行振込などの方法から選びます。利用できる方法は貴店の KOMOJU アカウントとカート通貨によります。カード情報が貴店のサイトを通ることはありません。注文は KOMOJU が支払いを確認した後にのみ作成されるため、途中で離脱した決済によって未払い注文が残ることはありません。
KOMOJU 加盟店アカウントで地域の決済方法を提供したい、日本、アジア、ヨーロッパのショップに適しています。本モジュールは都度払いのみに対応します。PrestaShop には、サイト内のカードフォーム、保存済みカード、定期購入、手動キャプチャ操作はありません。
主な機能
KOMOJU ホスト型ページ：カート合計額とカート通貨で決済セッションを作成します。JPY、KRW、VND は小数なしで送信します。KOMOJU が対応する 20 通貨でのみ提供されます。
KOMOJU 確認後にのみ支払い済みに：注文は、貴店のウェブフックのシークレットトークンで署名されたウェブフックを受信した後、または購入者が戻った際に KOMOJU API から決済セッションを読み取った後に作成されます。購入者の帰還だけでは注文の支払いは確定しません。
金額と通貨の照合：不一致の場合、注文はメモ付きで KOMOJU payment on hold になります。KOMOJU が別の通貨に換算した決済は、決済セッションで検証します。
コンビニ払いと銀行振込：払込票が発行されると注文は Awaiting KOMOJU payment で待機し、購入者が支払うと Payment accepted になります。払込票の期限が切れると注文はキャンセルされます。
重複処理を防止：繰り返しまたは同時に届くウェブフックと帰還要求は、決済を一度だけ確定します。新しい試行は開いているセッションを再利用し、古いセッションの支払いも引き続き認識されます。
テストと本番モード：秘密キーとウェブフックのシークレットトークンを別々に設定します。各決済がモードを記憶するため、切り替え後も返金や状態確認に正しいキーが使われます。
注文画面からの返金：KOMOJU payment ブロックで全額または一部の返金ができ、返金額は KOMOJU が実際に請求した金額までです。全額返金すると注文は Refunded になります。KOMOJU ダッシュボードで行った返金は自動的に記録されます。
注文画面の KOMOJU ブロック：KOMOJU ダッシュボードへのリンク付きの決済、返金履歴、モジュールのメモを表示します。ログにはキーや購入者データを含みません。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。秘密キーとウェブフックのシークレットトークンを持つ KOMOJU 加盟店アカウント。vibefox.net の VibeFox ライセンスキー（ドメインごとに 1 キー）。