概要
VibeFox Vindi Gateway は、PrestaShop を Vindi API に接続し、ブラジルレアル（BRL）で販売するブラジルのショップ向けの決済を提供します。購入者は Vindi の請求書ページでクレジットカード決済を行うか、boleto、PIX、BolePix（boleto + PIX）を選べます。カード情報がショップのサイトを経由することはありません。boleto と PIX の場合、注文は Awaiting Vindi payment のまま残り、購入者は注文確認ページ、マイアカウント、メールで boleto のリンク、PIX の QR コード、PIX のコピー＆ペースト用コードを受け取ります。
すでに Vindi アカウントを持ち、カードフォームを自前で用意せずに単発の決済を受け付けたいブラジルのショップに適しています。カード決済では、Vindi が決済を確認した後にのみ注文が作成されるため、途中で離脱した決済によって未払いの注文が残ることはありません。本モジュールが扱うのは、1 回払いの単発決済だけです。定期購入や継続課金、保存済みカード、分割払い（parcelamento）には対応しておらず、ショップのサイト上にカードフォームも表示されません。また、boleto 決済の返金はできません。
主な機能
4 種類の決済方法: クレジットカード、boleto、PIX、BolePix。チェックアウトで提供する方法を選択できます。
CPF / CNPJ フィールド: boleto と PIX の場合にチェックアウトで入力を求め、検証番号で入力内容を確認します。可能な場合は、購入者の住所情報から自動入力されます。
Vindi が確認した場合にのみ支払い済みに: モジュールが Vindi API から請求書を読み取り、通貨、カートコード、Vindi の顧客、支払い金額が一致することを確認した後にのみ、決済を受け付けます。不一致の場合、注文はメモ付きで保留になります。
保護されたウェブフック: ウェブフックの URL には秘密のトークンが含まれています。各通知は、Vindi API を通じた再確認をトリガーするだけです。
二重決済の防止: 新しい決済試行では、保留中の Vindi 請求書を再利用するか、先にキャンセルします。ショップで未払いの注文をキャンセルすると、対応する Vindi 請求書もキャンセルされます。
本番環境とサンドボックス: API キーは別々に設定します。各決済は請求書を作成した環境を記録するため、確認と返金は常にその環境で行われます。
注文画面からの返金: Vindi payment ブロックから、カードおよび PIX 決済の全額返金と一部返金ができます。返金額は Vindi が実際に請求した金額までです。全額返金を行うと、注文は Refunded になります。
注文画面の Vindi ブロック: カートの請求書、返金履歴、モジュールのメモを表示します。
要件
PrestaShop 8.0 から 9.x、PHP 8.0 以降、ショップ通貨はブラジルレアル（BRL）。API キーを持つ Vindi アカウント（テスト用の Vindi サンドボックスアカウントも必要）。vibefox.net で入手した VibeFox ライセンスキー（ドメインごとに 1 つ）。