概要
VibeFox Worldline Gateway は、PrestaShop を Worldline Direct（旧 Ingenico Direct）のホステッド決済ページに接続します。支払いの段階で購入者は Worldline を選択し、安全な Worldline の決済ページに移動して、カード、ウォレット、または貴社の Worldline アカウントで有効になっている他の決済方法で支払い、ストアに戻ります。カード情報が貴社のサイトを経由することはなく、中断された支払いが未払いの注文として残ることもありません。
Worldline Direct の加盟店アカウントを既にお持ちで、自社サイトにカードフォームを置かずにホステッド決済ページを利用したいストアに適しています。本モジュールは、単発の支払いを直接販売として受け付けます。保存済みカード、サブスクリプション、埋め込み型カードフォーム、PrestaShop からのキャプチャまたはキャンセルを伴う承認のみのモード、サーチャージ、Webhook の自動登録には対応していません。
主な機能
Worldline Direct ホステッド決済ページ: カート金額をカートの通貨で決済ページに設定します。JPY などの小数点なし通貨や、KWD などの小数点第 3 位までの通貨にも対応しています。Merchant Portal で作成した任意のページテンプレートを使用できます。
Worldline が確認した場合のみ注文を作成: 注文は、購入者が戻った際のサーバー側でのステータス確認後、または有効な Worldline 署名付きの Webhook を受信した後にのみ作成されます。
金額とカートの照合: 支払いはこのカートの支払い試行に属している必要があり、金額と通貨がカートと一致しなければなりません。一致しない場合、注文はメモ付きで Worldline payment on hold になります。
二重処理の防止: 繰り返し発生した戻りや Webhook によって注文が二度作成されることはありません。遅れて届いた支払いがキャンセル済みの注文を再開させることはなく、支払い済みの注文に対する 2 回目の支払いは注文メモに記録されます。
テストアカウントと本番アカウントの分離: テストモードでは事前本番環境とテスト用認証情報を、ライブモードでは本番環境とライブ用認証情報を使用します。Check credentials ボタンで各認証情報を確認できます。
注文画面からの返金: 注文の Worldline payment ブロックから全額返金と一部返金ができます。返金額は Worldline が請求した金額で、返金は常に元の支払いと同じ環境で行われ、二重返金からも保護されます。
任意の注文ステータス: キャプチャされた支払いの後に Payment accepted または Delivered を選べます。承認済みの支払いは Awaiting Worldline capture で待機します。
注文画面の Worldline ブロック: 支払い ID、リファレンス、返金履歴、メモを表示します。エラーは常にログに記録され、キー、カード情報、個人情報はマスクされます。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。Worldline Direct の加盟店アカウント（テストと本番の両方）と、加盟店 ID（PSPID）、API キー、Webhook キー。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。