概要
VibeFox Helcim Gateway は、Helcim Payment API によるクレジットカード決済を PrestaShop に追加します。購入者は、チェックアウトの支払いステップでカード情報を入力し、貴店のサーバーから 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 ウェブフックもありません。Helcim ダッシュボードで行われたキャプチャ、返金、取り消しは PrestaShop に反映されません。
主な機能
チェックアウトのカードフォーム: カード番号、有効期限、CVC、カード名義人を送信前に検証（カード番号のチェックサム、有効期限が過去でないこと、CVC の桁数）し、カードブランドのアイコンを表示します。
即時決済または事前承認: カードに即時請求するか、または資金の仮押さえのみを行い、後から注文内の Helcim ブロックにある Capture payment でキャプチャします。
承認後にのみ注文を作成: Helcim が取引を承認した後にのみ注文が作成されます。拒否されたカードでは注文は作成されません。承認された金額または通貨がカートと一致しない場合、注文はメモ付きで Helcim payment on hold になります。
カートにつき 1 回の請求: 並行送信はロックされ、支払い済みのカートに再度請求されることはありません。すべての試行で冪等性キーが使用されます。そのため、タイムアウト後の再試行では、カードに二重請求される代わりに元の Helcim の結果が返されます。
注文画面からの返金: 注文内の Helcim ブロックで全額返金および一部返金が可能です。返金額は Helcim が実際に請求した金額までです。未キャプチャの事前承認を全額返金すると、仮押さえが解除されます。
本番およびテスト用トークン: 本番用とテスト用の Helcim アカウントに個別の API トークンを設定できます。キャプチャと返金には、注文の支払いに使用されたアカウントが常に使用されます。
注文画面の Helcim ブロック: トランザクション ID、カード種別と末尾 4 桁、承認金額、返金履歴、モジュールのメモを表示します。カード番号、CVC、トークン、個人データを含まないエラーログを記録します。
要件
PrestaShop 8.0 ～ 9.x、PHP 8.0 以降。Helcim 加盟店アカウント（カナダまたは米国）と API トークン。ストアの HTTPS および PCI DSS 準拠ホスティング。vibefox.net の VibeFox ライセンスキー（1 ドメインにつき 1 キー）。