概要
VibeFox Yoco Pay Gateway は、Yoco Checkout API を通じて、南アフリカ・ランド（ZAR）建てのカード決済と Instant EFT を OpenCart 3 と OpenCart 4 に追加します。最後のチェックアウト手順で購入者が Confirm Order をクリックすると、Yoco がホストする決済ページに移動し、そこで支払ってストアに戻ります。カード情報がお客様のサイトを経由することはありません。OpenCart は支払いの前に注文を作成しますが、注文にステータスが付くのは Yoco が支払いを確認した後だけです。そのため、未払いの試行は注文の欠落として残ります。
ZAR で販売し、オンライン決済を備えた Yoco アカウントを持つ南アフリカのストアに適しています。本拡張機能は 1 回限りの支払いのみに対応します。保存済みカード、定期購入、ストア上のカード入力フォーム、与信と売上確定の分離はありません。ZAR 専用で、注文の最低金額は R2.00 です。
主な機能
Yoco がホストするチェックアウト:注文合計金額（セント単位）に対して Yoco のチェックアウトが作成されます。ダブルクリックやタイムアウトの後に繰り返されたリクエストには、2 つ目ではなく同じチェックアウトが返されます。
Yoco が確認した場合のみ支払い済みに:顧客が戻ったときと、署名付き Webhook が届いたときに、拡張機能は Yoco にチェックアウトの状態を問い合わせます。注文にステータスが付くのは、Yoco がチェックアウトの完了を報告したときだけです。その後、OpenCart は通常の注文メールを送信します。
Webhook は自動で設定:シークレットキーを保存すると、拡張機能はそのモードの Webhook URL を Yoco に登録し、署名用シークレットを保存します。有効な署名のない Webhook は拒否されます。
金額と通貨の確認:金額または通貨が異なる支払いは、注文をメモ付きの確認ステータスにします。キャンセルされた注文や返金済みの注文への支払いは、その注文を再開しません。
二重処理の防止:同時に届いた Webhook と顧客の戻りは、順番に処理されます。支払い済みのカートに再度請求されることはなく、2 回目の支払いは注文のメモに記録されます。
注文ページからの返金:注文の VibeFox Yoco Pay Gateway タブで、全額返金と一部返金ができます。返金額は Yoco が請求した金額で、支払いが行われたモードのキーを使用します。Yoco ポータルで行われた返金は自動的に記録されます。
テストモードと本番モード:モードごとに別々のシークレットキーと Webhook シークレットを使用します。プレフィックスが違うキーは保存されません。
独自の注文ステータスと OpenCart の条件:支払い済みの注文、確認中の支払い、全額返金のステータスを選べます。ジオゾーン、最低注文金額、並べ替え順序も設定できます。ログではキーとメールアドレスが伏せられます。
要件
OpenCart 3.0.x（3.0.5.0 で検証済み）または OpenCart 4.0.2 以降（4.1.0.3 で検証済み）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。ストアで有効になっている南アフリカ・ランド（ZAR）の通貨。オンライン決済を備えた Yoco アカウントとそのシークレットキー。vibefox.net で入手した VibeFox ライセンスキー（ドメインごとに 1 つ）。