概要
VibeFox Square Gateway は、Square によるクレジットカードとデビットカードの決済を OpenCart 3 および OpenCart 4 に追加します。Confirm Order のステップで、購入者は Square の安全なカードフォーム（Square Web Payments SDK）にカード情報を入力します。お客様のサーバーが受け取るのは 1 回限りのトークンだけで、Square Payments API を通じて請求されます。カードのデータがストアに届くことはありません。OpenCart は決済の前に注文を作成しますが、注文にステータスが付くのは Square から応答があった後です。そのため、拒否された試行は注文欠落のままになります。
自店のチェックアウトでカード決済を提供したい Square 加盟店に適しています。決済通貨は Square ロケーションの通貨（USD、CAD、AUD、JPY、GBP、EUR）に限られます。拡張機能は 1 回限りのカード決済に対応し、即時に請求されます。保存済みカード、サブスクリプション、Apple Pay、Google Pay、Cash App Pay、Afterpay、Square ギフトカードには対応していません。オーソリのみの決済と Square のウェブフックにも対応していません。
主な機能
3-D Secure / SCA: カードのトークン化の際に購入者の認証が行われ、注文合計、通貨、支払い住所が Square に渡されます。
Square が確認した場合のみ支払い済み: 注文が支払い済みになるのは、決済の状態が COMPLETED で、金額、通貨、注文番号、ロケーションが注文と完全に一致する場合だけです。想定外の値があった場合は、注文にメモを付けて確認用のステータスに設定します。
二重請求なし: カートごとに同時に実行される決済は 1 件だけで、リクエストは冪等性を保ちます。応答が失われた試行は、カードを再度請求する代わりに Square で照会されます。
認証情報と通貨の確認: アクセストークンとロケーションは、保存時に Square で確認されます。Square ロケーションで請求できない通貨の注文では、この決済方法は表示されません。
注文画面からの返金: 注文の VibeFox Square Gateway タブから全額返金と一部返金ができます。返金は、実際の決済が行われた環境、ロケーション、金額、通貨で処理されます。全額返金を行うと Refunded ステータスに設定されます。
注文画面の Square タブ: 決済 ID（Square ダッシュボードへのリンク付き）、カード情報、レシート、返金履歴、メモを表示します。
分かりやすいメッセージ: 購入者には短いメッセージが表示されます（カード拒否、CVV 誤り、3-D Secure が必要など）。エラーは必ず記録されますが、キーやカードデータは含まれません。
OpenCart の条件設定: 独自の注文ステータス、ジオゾーン、最低注文金額、並び順を設定できます。
要件
OpenCart 3.0.x（3.0.5.0 で検証済み）または OpenCart 4.0.2 以降（4.1.0.3 で検証済み）、PHP 8.0 以降。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。Square Developer Dashboard でアプリケーションを作成した Square アカウント（Application ID、Access Token、Location ID）。注文の通貨は Square ロケーションの通貨と一致している必要があります（USD、CAD、AUD、JPY、GBP、EUR）。VibeFox ライセンスキー（vibefox.net で購入。1 つのキーは 1 つのドメインで使用可能）。