概要
VibeFox Viva Wallet Gateway は、Viva Wallet（Viva.com）の Smart Checkout を OpenCart 3 と OpenCart 4 に追加する拡張機能です。購入者は最後のチェックアウト手順で Confirm Order をクリックすると、Viva の安全な決済ページに移動し、カード、Apple Pay、Google Pay、または Viva アカウントで有効になっているローカル決済方法で支払い、ストアに戻ります。カード情報がストアのサイトを経由することはありません。OpenCart は決済の前に注文を作成しますが、注文にステータスが付与されるのは Viva API で決済が確認された後です。そのため、未払いの試行は未完了の注文として残ります。
この拡張機能は、Viva の加盟店アカウントを持ち、自店のページにカードフォームを置く代わりにホステッド決済ページを使いたいストアに適しています。一回限りの支払いのみに対応しており、事前承認と売上確定、分割払い、カードの保存、定期購読、自店ページのカード入力欄、POS 端末には対応していません。また、Viva のダッシュボードで行った返金は取り込まれません。
主な機能
Smart Checkout: 注文通貨で注文合計に対応する Viva 決済注文が作成され、通貨の正しい最小単位が使用されます。
Viva が確認した場合にのみ支払い済み: Viva の Webhook は署名されていないため、拡張機能は Viva API からすべての取引を取得し直します。取引はこの注文の決済注文に属し、完了しており、注文金額および通貨と一致している必要があります。
Webhook と戻り: 注文は Viva の Webhook により、または購入者がストアに戻ったときにステータスを取得します。Viva による Webhook URL の確認には、加盟店 ID と API Key を使って自動的に応答します。
二重処理の防止: 繰り返し届いたり並行して届いたりする Webhook や戻りが、同じ支払いを二度適用することはありません。1 つのカートは 1 回だけ支払われ、遅れて届いた支払いがキャンセル済みまたは返金済みの注文を再オープンすることもありません。
金額と通貨の確認: 不一致があった場合、注文は選択した確認用ステータスになり、メモが残されます。
デモアカウントと本番アカウント: それぞれ別の認証情報を使用します。開始済みの支払いは、Test Mode を切り替えた後も、支払いが行われたアカウントで確認・返金されます。
注文ページからの返金: 注文の VibeFox Viva Wallet Gateway タブから、Viva が請求した金額までの全額返金および一部返金ができます。返金は支払いのアカウントと通貨で処理され、返金履歴、支払い試行、Viva のメモも表示されます。
OpenCart の設定: 注文ステータス、ジオゾーン、最低注文金額、並び順を独自に設定できます。Viva の決済ページのブランドカラーを指定でき、ログにはキーや購入者データは記録されません。
要件
OpenCart 3.0.x（3.0.5.0 で動作確認済み）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認済み）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。Smart Checkout の認証情報（Client ID と Client Secret）と支払いソース（Source Code）を持つ Viva の加盟店アカウント。注文通貨は EUR、GBP、PLN、RON、BGN、CZK、HUF、DKK、SEK、NOK、CHF のいずれか。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。