概要
VibeFox Helcim Gateway は、Helcim Payment API による クレジットカード決済を OpenCart 3 と OpenCart 4 に追加します。購入者は最後のチェックアウトステップで、Confirm Order ボタンの上にあるフォームにカードを入力します。貴店のサーバーがそれを Helcim に送信し、注文のステータスは同じリクエスト内の Helcim の応答によって決まります。Visa、Mastercard、American Express、Discover、UnionPay に対応し、通貨は CAD または USD です。
カナダおよびアメリカ合衆国の加盟店で、Helcim アカウントを持ち、チェックアウトページに直接カードフォームを表示したい方に適しています。カード情報は貴店の Web サーバーを経由するため、HTTPS と PCI DSS に準拠したホスティング（SAQ D）が必要です。本拡張機能は、保存済みカード、サブスクリプション、ACH や銀行振込、Apple Pay、Google Pay、3-D Secure には対応しておらず、Helcim の Webhook もありません。Helcim の管理画面で行った売上確定、返金、取り消しは OpenCart には反映されません。
主な機能
チェックアウトページのカードフォーム：カード番号、有効期限、CVC、カード名義人を送信前にチェックします（カード番号のチェックサム、有効期限が過ぎていないこと、CVC の桁数）。
売上または事前承認：カードに即時請求するか、資金の確保のみを行い、後から注文のタブで Capture payment を使って売上確定（キャプチャ）することができます。
承認後にのみステータスを設定：OpenCart は決済の前に注文を作成しますが、Helcim が取引を承認するまで注文ステータスは付与されません。そのため、カードが拒否された場合は注文が欠落した状態のみが残ります。承認された金額や通貨が注文と一致しない場合、注文はメモ付きで確認用ステータスに移行します。
カートごとに 1 回の請求：同時送信はロックされ、支払い済みのカートが再び請求されることはありません。また、すべての試行で冪等キーを使用するため、タイムアウト後の再試行は、カードを二重に請求する代わりに Helcim の元の結果を返します。
注文ページからの返金：注文の VibeFox Helcim Gateway タブから、全額返金と一部返金ができます。返金額は Helcim が実際に請求した金額までです。キャプチャされていない事前承認は全額解放されます。
本番用とテスト用のトークン：Helcim の本番アカウントとテストアカウントで、それぞれ別の API トークンを使用します。売上確定と返金は、注文が決済されたアカウントを常に使用します。
独自の注文ステータス：支払い済みの注文、事前承認、確認待ちの注文、解放された事前承認、全額返金のそれぞれに対して、OpenCart のステータスを選択できます。ジオゾーン、最低金額、並び順は、他の OpenCart 決済方法と同じように設定します。カード番号、CVC、トークン、個人情報を含まないエラーログを記録します。
動作環境
OpenCart 3.0.x（3.0.5.0 で動作確認済み）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認済み）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン向けのパッケージが含まれています。Helcim の加盟店アカウント（カナダまたはアメリカ合衆国）と API トークン。チェックアウトの通貨は CAD または USD。貴店での HTTPS と、PCI DSS に準拠したホスティング。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 つ）。