概要
VibeFox Tpay Payment は、ポーランドのストア向けに OpenCart 3 と OpenCart 4 へ Tpay を追加する拡張機能です。チェックアウトの最後のステップで、購入者は Confirm Order をクリックし、Tpay の安全な決済ページへ移動します。そこでは BLIK、オンラインバンク振込、カード、そして Tpay アカウントで有効になっているその他の決済方法が提供されます。本拡張機能は Tpay Open API を使用します。OpenCart は決済の前に注文を作成しますが、注文は Tpay が決済を確認した後にのみステータスを受け取ります。そのため、未払いの試行は欠番の注文として残ります。
ズロチ（złoty）で販売し、BLIK、銀行振込、カードをひとつの決済方法にまとめたいポーランドのストアに適しています。本拡張機能は PLN のみで動作します。購入者は銀行を選んだり BLIK コードを入力したりするのは、ストアではなく Tpay のページで行います。保存済みカード、サブスクリプション、ストア内の Apple Pay や Google Pay のボタン、分割払いの計算機はありません。
主な機能
Tpay 決済ページ: 安全な Tpay ページで BLIK、オンラインバンク振込、カード、その他の Tpay 決済方法を提供します。ページはポーランド語、英語、ウクライナ語で表示されます。
Tpay が確認した場合のみ支払い済み: 注文は、Tpay からの通知が MD5 チェックサム（お使いのセキュリティコード）、Merchant ID、JWS 署名の検証に合格した後、または購入者が戻った際のサーバー側でのステータス確認の後に、ステータスを受け取ります。金額は注文と一致している必要があります。一致しない場合は、注文はメモ付きのレビュー用ステータスになります。
安全な再決済: 決済の試行ごとに個別の参照番号があります。新しい試行を行うと、その注文および同じカートの以前の未払い Tpay 取引はキャンセルされます。以前のリンクからの決済も引き続き受け付けられます。
二重処理なし: 重複したり同時に届いたりした通知によって決済が二重に適用されることはなく、支払い済みのカートに再度請求されることもありません。支払い済みの注文への 2 回目の決済は、メモとして記録されるだけです。
注文ページからの返金: 注文の VibeFox Tpay Payment タブから全額返金と一部返金を行えます。返金は常に、注文が支払われた環境（サンドボックスまたは本番）で行われ、Tpay が受け取った金額が上限です。
サンドボックスと本番: 環境ごとに別々のキーを使用します。サンドボックスモードを切り替えると、キーと API ホストの両方が切り替わります。
独自の注文ステータスと OpenCart の条件: 支払い済み、レビュー中、返金済みの注文のステータス、ジオゾーン、最低注文金額、並び順を選べます。キーや顧客データを含まないログも任意で有効にできます。
要件
OpenCart 3.0.x（3.0.5.0 でテスト済み）または OpenCart 4.0.2 以降（4.1.0.3 でテスト済み）、PHP 8.0 以降（JWS 署名の確認のため OpenSSL 拡張機能を含む）。1 つのダウンロードに両方のバージョン用のパッケージが含まれています。ストアで設定された PLN 通貨。Merchant ID、Open API の Client ID と Client secret、および通知用のセキュリティコードを持つ Tpay 加盟店アカウント。vibefox.net で入手した VibeFox ライセンスキー（ドメインごとに 1 つ）。