概要
VibeFox Yoco Pay Gateway は、南アフリカ・ランド（ZAR）建てのカード決済と Instant EFT を、Yoco Checkout API を通じて PrestaShop に追加します。決済ステップでお客様は Yoco を選択し、Yoco がホストする決済ページに移動して支払いを行ったあと、ショップに戻ります。カード情報がお客様のサイトを経由することはなく、決済を途中で中断しても未払いの注文は残りません。
ZAR で販売し、オンライン決済が有効な Yoco アカウントを持つ南アフリカのショップに適しています。本モジュールは単発の決済のみに対応しています。保存済みカード、サブスクリプション、サイト上のカード入力フォーム、別々の承認とキャプチャには対応していません。ZAR のみで動作し、注文の最低金額は R2.00 です。
主な機能
Yoco がホストする決済ページ：カート合計金額をセント単位にした Yoco チェックアウトを作成します。ダブルクリックやタイムアウト後の再リクエストでは、2 つ目ではなく同じチェックアウトが返されます。
Yoco が確認した場合にのみ支払い済みに：お客様が戻ったときと、署名付きウェブフックを受信したときに、モジュールが Yoco にチェックアウトの状態を照会します。Yoco がチェックアウトの完了を報告した場合にのみ、注文が作成されます。
ウェブフックを自動設定：シークレットキーを保存すると、モジュールはそのモード用のウェブフック URL を Yoco に登録し、署名シークレットを保存します。有効な署名のないウェブフックは拒否されます。
金額と通貨の確認：金額または通貨が異なる支払いがあると、注文はメモ付きで Yoco payment on hold になります。キャンセル済みまたは返金済みの注文への支払いでは、注文は再開されません。
二重処理の防止：ウェブフックとお客様の戻りがほぼ同時に届いた場合は、順番に処理されます。1 つのカート、1 つの注文、1 件の記録済み支払いとなります。
注文ページからの返金：注文の Yoco payment ブロックから全額・部分返金ができます。返金額は Yoco が請求した金額で、支払いが行われたモードのキーを使用します。Yoco ポータルで行われた返金は自動的に記録されます。
テストモードと本番モード：モードごとに別々のシークレットキーとウェブフックシークレットを使用します。接頭辞が誤ったキーは保存されません。
注文ページの Yoco ブロック：支払い、カートのすべての支払い試行、返金履歴、モジュールのメモを表示します。ログではキーとメールアドレスをマスクします。
要件
PrestaShop 8.0 ～ 9.x、PHP 8.0 以降。ショップの通貨は南アフリカ・ランド（ZAR）。オンライン決済が有効な Yoco アカウントとそのシークレットキー。vibefox.net で入手できる VibeFox ライセンスキー（ドメインごとに 1 つ）。