概要
VibeFox Square Gateway は、Square によるクレジットカードとデビットカードの決済を PrestaShop に追加します。支払いの手順では、購入者は支払い方法の下に表示される安全な Square カードフォーム（Square Web Payments SDK）にカード情報を入力します。ショップのサーバーが受け取るのは 1 回限りのトークンだけで、そのトークンを Square Payments API 経由で請求します。カード情報がショップに届くことはなく、注文は Square が決済を確認した後にのみ作成されます。
米国、カナダ、オーストラリア、日本、英国、アイルランド、フランス、スペインで Square を利用しており、自店のチェックアウトページでカード決済を受け付けたい販売者に適しています。本モジュールは、即時に売上を確定する 1 回払いのカード決済に対応しています。保存済みカード、サブスクリプション、Apple Pay、Google Pay、Cash App Pay、Afterpay、Square ギフトカードには対応しておらず、オーソリのみの決済や Square の Webhook にも対応していません。
主な機能
3-D Secure / SCA：カードをトークン化する際に購入者の本人確認を行い、カート合計、通貨、請求先情報を Square に渡します。
Square が確認した場合のみ支払い済み：注文は、カート合計、通貨、カートの参照番号、ロケーションが完全に一致する COMPLETED の支払いがあった場合にのみ Payment accepted となります。想定外の状態があれば、注文は備考付きで Square payment on hold になります。
二重請求なし：カートごとに同時に実行される支払い試行は 1 回だけで、リクエストは冪等（べきとう）です。応答が届かなかった試行は、カードを再度請求する代わりに Square 側で確認されます。
認証情報と通貨のチェック：アクセストークンとロケーションは、保存時に Square で確認されます。Square ロケーションで請求できない通貨のカートでは、支払い方法は表示されません。
注文画面からの返金：注文の Square ブロックから全額返金と一部返金ができます。返金は常に、実際の支払いと同じ環境、ロケーション、金額、通貨で行われます。全額返金を行うと、注文は Refunded になります。
注文画面の Square ブロック：Square Dashboard へのリンク付きの支払い ID、カード、領収書、返金履歴、備考。
分かりやすいメッセージ：購入者には、拒否、CVV の誤り、3-D Secure の必要性などを示す短いメッセージが表示されます。エラーは常にログに記録されますが、キーやカードデータは含まれません。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降。Square Developer Dashboard でアプリケーションを作成済みの Square アカウント（Application ID、Access Token、Location ID）。カートの通貨は、Square ロケーションの通貨と同じである必要があります：USD、CAD、AUD、JPY、GBP、EUR のいずれか。vibefox.net で購入した VibeFox ライセンスキー（1 つのキーは 1 つのドメインで使用可能）。