概要
VibeFox Viva Wallet Gateway は、Viva Wallet（Viva.com）Smart Checkout を PrestaShop に追加します。チェックアウトの支払い段階で購入者は Viva Wallet を選択し、Viva の安全な決済ページに移動して、カード、Apple Pay、Google Pay、または Viva アカウントで有効になっているローカル決済方法で支払い、ストアに戻ります。カード情報が貴サイトを経由することはありません。注文は Viva が支払いを確認した後にのみ作成されるため、途中で中断された支払いによって未払いの注文が残ることはありません。
自サイトのカードフォームではなく、ホストされた決済ページを利用したい、Viva の加盟店アカウントを持つショップに適しています。本モジュールは単発の支払いのみに対応しています。事前承認とキャプチャ、分割払い、保存済みカード、サブスクリプション、自サイトのページでのカード入力欄、POS 端末には対応しておらず、Viva ダッシュボードで行った返金は取り込まれません。
主な機能
Smart Checkout: カートの合計金額について、カートの通貨で Viva 決済注文が作成されます。通貨の正しい最小単位が使用されます。
Viva が確認した場合にのみ支払い済み: Viva のウェブフックには署名がないため、モジュールは各取引を Viva API から再取得します。その取引はこのカートの Viva 決済注文に属し、完了しており、カートの合計金額と通貨に一致する必要があります。
ウェブフックと戻り: 注文は Viva のウェブフック、または購入者がショップに戻ったときに作成されます。Viva によるウェブフック URL の検証には、加盟店 ID と API Key で自動的に応答します。
二重処理なし: 繰り返し届いたウェブフックや並行して発生した戻りによって、2 つ目の注文が作成されたり、支払いが二重に記録されたりすることはありません。遅れて届いた支払いが、キャンセル済みまたは返金済みの注文を再度開くこともありません。
金額と通貨のチェック: 不一致がある場合、注文は Viva Wallet payment on hold となり、確認のためのメモが追加されます。
デモアカウントと本番アカウント: それぞれ個別の認証情報を設定します。開始済みの支払いは、Test Mode を切り替えた後も、支払いが行われたアカウントで確認・返金されます。
注文ページからの返金: 注文の Viva Wallet payment ブロックで全額返金と一部返金ができます。返金は Viva が請求した金額までで、支払いのアカウントと通貨で行われます。全額返金を行うと注文は Refunded になります。
注文ページの Viva ブロック: 取引、支払い試行、返金履歴、メモを表示します。支払い後の注文ステータスは任意に選択でき、ログにはキーや購入者データは含まれません。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。Smart Checkout の認証情報（Client ID と Client Secret）と決済ソース（Source Code）を持つ Viva の加盟店アカウント。カートの通貨は EUR、GBP、PLN、RON、BGN、CZK、HUF、DKK、SEK、NOK、CHF のいずれか。vibefox.net で入手できる VibeFox ライセンスキー（ドメインごとに 1 つ）。