概要
VibeFox MercadoPago Gateway は、OpenCart 3 および OpenCart 4 に MercadoPago Checkout API によるクレジットカードおよびデビットカードの決済を追加します。対象は、アルゼンチン、ブラジル、チリ、コロンビア、メキシコ、ペルー、ウルグアイの MercadoPago アカウントです。Confirm Order のステップで購入者は、MercadoPago が提供する安全な MercadoPago.js フィールドにカード情報を入力するため、カードデータが貴店のサイトに届くことはありません。MercadoPago はカードを 1 回限りのトークンに変換し、貴店がサーバー側で決済を作成します。OpenCart は決済の前に注文を作成しますが、注文に状態が付くのは MercadoPago が応答した後です。そのため、拒否されたカードは状態のない注文を残します。
MercadoPago アカウントの通貨で販売し、自店のチェックアウトページにカードフォームを表示して分割払いも提供したいストアに適しています。本拡張機能はカード決済のみに対応します。Checkout Pro へのリダイレクト、MercadoPago ウォレット、現金、Pix、PSE、Yape には対応していません。保存済みカードやサブスクリプション、オーソリとキャプチャの分離、通貨換算もサポートしていません。
主な機能
チェックアウトページのカードフォーム：カード番号、有効期限、セキュリティコードは MercadoPago のフィールドに入力されます。カード名義人、国が必要とする場合の名義人の書類、必要に応じたカード発行会社、そして MercadoPago が注文合計に対して提供する分割払い（cuotas、parcelas）を選択できます。分割回数は Maximum installments の設定で制限されます。
MercadoPago が確認した場合にのみ支払い済み：金額と通貨が一致する承認済みの決済は、選択した支払い済みステータスに設定されます。審査中の決済は、MercadoPago の通知によって完了されるまで、審査中のステータスのまま待機します。金額が一致しない場合は、注文はメモ付きの審査ステータスになります。その後、OpenCart は通常どおり注文メールを送信します。
安全な通知：注文が変更される前に、すべての通知を MercadoPago API から再取得して検証します。任意で x-signature の署名チェックも行えます。
二重請求の防止：カートごとのロック、カードトークンごとの冪等キー、失われた応答の照会により、ダブルクリック、2 つ目のタブ、タイムアウトによる二重請求を防ぎます。支払い済みのカートに再度請求されることはありません。
テストモードと本番モード：TEST- と APP_USR- の認証情報を個別に使用します。保存時にプレフィックスとアカウントの国が照合されます。返金と通知は、決済が行われたモードの認証情報を使用します。
注文ページからの返金：注文の VibeFox MercadoPago Gateway タブから、実際に請求された金額の範囲内で全額返金と一部返金ができます。決済の詳細、返金履歴、MercadoPago のメモも確認できます。全額返金を行うと、ステータスは Refunded になります。
独自の注文ステータスと OpenCart の条件：支払い済みの注文、MercadoPago で審査中の決済、保留中の決済、失敗した決済、キャンセルされた注文、返金された注文のそれぞれに対して、OpenCart のステータスを選択できます。ジオゾーン、最低注文金額、並び順も設定できます。ログにはトークン、カード情報、支払者のデータは記録されません。
要件
OpenCart 3.0.x（3.0.5.0 で動作確認済み）または OpenCart 4.0.2 以降（4.1.0.3 で動作確認済み）、PHP 8.0 以降。このダウンロードには両方のバージョン用のパッケージが含まれています。MercadoPago アカウントの通貨と同じ、有効な店舗通貨（ARS、BRL、CLP、COP、MXN、PEN、UYU のいずれか）。テスト用と本番用の Public Key および Access Token を持つ MercadoPago アプリケーション。vibefox.net で取得した VibeFox ライセンスキー（ドメインごとに 1 キー）。