概要
VibeFox Kushki Payment は、エクアドルとコロンビアのストア向けに、Kushki によるカード決済を OpenCart 3 および OpenCart 4 に追加します。Confirm Order の段階で、購入者はチェックアウトページ内に表示される Kushki 提供のホステッドカードフォームにカード情報を入力します。フォームは 1 回限りのトークンを返し、ストアは Kushki API を通じてサーバー側でそのトークンを請求します。カード番号がお客様のサイトに届くことはありません。OpenCart は決済の前に注文を作成しますが、注文にステータスが設定されるのは Kushki が請求を承認した後です。そのため、拒否された決済や途中で放棄された決済は、ステータスのない注文（missing orders）として残ります。
USD または COP で請求し、カード情報を扱わずに自店のチェックアウトページにカードフォームを表示したいストアに適しています。本拡張機能は 1 段階の決済のみに対応しています。部分返金、カードの保存、定期購入、現金や銀行振込（PSE）による決済、リダイレクトを使うデビットカード決済、オーソリとキャプチャの分離には対応していません。
主な機能
Kushki のホステッドカードフォーム：OpenCart チェックアウトの Confirm Order 段階に表示される Kushki のカードフォームです。購入者がフォーム内の決済ボタンを押すと、すぐに決済が送信されます。フォームで選択した分割払い（diferido）は請求に引き継がれます。
Kushki が確認した場合のみ支払い済みに：注文のステータスは、Kushki がチケット番号付きで請求を承認した後にのみ設定されます。Kushki が報告した金額または通貨が異なる場合、注文はメモ付きのレビュー状態になります。その後、OpenCart は通常の注文メールを送信します。
税金は IVA として：金額と通貨は注文から取得されます。注文の税金は IVA として Kushki に報告され、非課税の明細は別途報告されます。
署名付き Webhook：任意の Webhook により、API の応答が失われた決済を確認できるほか、Kushki Console で行われた取り消し（void）や返金に関するメモを追加できます。有効な署名のない通知は拒否されます。
二重請求の防止：カートごとのロックにより、ダブルクリックや 2 つ目のタブによる二重請求を防ぎます。支払い済みのカートが再び請求されることはありません。繰り返し届く Webhook によって決済が 2 回適用されることもありません。
テストモードと本番モード：モードごとに個別の Merchant ID と Webhook 署名を使用します。返金は常に、決済が行われたモードで処理されます。
注文ページからの全額返金：注文の VibeFox Kushki Payment タブから、Kushki が請求した金額の全額を返金できます。チケット番号、リファレンス、返金履歴、Kushki のメモも表示されます。
独自の注文ステータスと OpenCart の条件：支払い済みの注文、レビュー中の決済、失敗した決済、キャンセルされた注文、返金された注文に対応する OpenCart ステータスを選択できます。地域（Geo Zone）、最低注文金額、並び順も設定できます。ログには Merchant ID、カードトークン、購入者のメールアドレスは含まれません。
要件
OpenCart 3.0.x（3.0.5.0 で検証済み）または OpenCart 4.0.2 以降（4.1.0.3 で検証済み）、PHP 8.0 以降。このダウンロードには両方のバージョン用のパッケージが含まれています。注文の通貨は USD または COP。テスト用と本番用の公開（Public）および非公開（Private）Merchant ID を持つ Kushki アカウント。本番決済には HTTPS が必要です。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。