VibeFox MercadoPago for OpenCart — ヘルプ

要件

OpenCart: 3.0.x（3.0.5.0 でテスト済み）または 4.0.2 以降（4.1.0.3 でテスト済み）。

PHP: 8.0 以降。

ストアの通貨: MercadoPago アカウントの国の通貨がストアで有効になっている必要があります: ARS（アルゼンチン）、BRL（ブラジル）、CLP（チリ）、COP（コロンビア）、MXN（メキシコ）、PEN（ペルー）、UYU（ウルグアイ）。MercadoPago はアカウントの通貨で請求し、通貨換算は行いません。そのため、この支払い方法はその通貨で支払うお客様にのみ表示されます。

MercadoPago アカウント: MercadoPago の開発者パネル（Your integrations > your application > Credentials）でアプリケーションを作成し、そのテスト用認証情報（TEST- で始まる）と本番用認証情報（APP_USR- で始まる）が必要です。それぞれについて Public Key と Access Token が必要です。通知の署名検証（任意）を行う場合は、your application > Webhooks に表示されるシークレット署名も必要です。

VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。

インストール

ダウンロードは 1 つの zip ファイルで、両方の OpenCart バージョン用のパッケージが含まれています。お使いのコンピューターで展開してください。含まれるのは README.txt、OpenCart 3 用パッケージ wcp_mercadopago_gateway-oc3-(version).ocmod.zip、OpenCart 4 用パッケージ wcp_mercadopago_gateway.ocmod.zip です。お使いの OpenCart バージョンのパッケージのみをインストールしてください。ライセンスキーは両方のバージョンで同じです。

OpenCart 3

1. 管理画面で Extensions > Installer に進み、Upload をクリックして、ファイル wcp_mercadopago_gateway-oc3-(version).ocmod.zip を選択します。この拡張機能には OCMOD の変更がないため、Extensions > Modifications を更新する必要はありません。インストーラーを使う代わりに、このパッケージの upload フォルダの内容をストアのルートフォルダにコピーすることもできます。

2. Extensions > Extensions に進み、種類 Payments を選択します。VibeFox MercadoPago Gateway を見つけて Install（緑色の + ボタン）をクリックします。管理者ユーザーに、支払い拡張機能の一覧を変更する権限が必要です。

3. Edit（鉛筆ボタン）をクリックして設定ページを開きます。ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを貼り付け、Activate をクリックします（ライセンスキーを参照）。

4. Account country を選択し、テスト用と本番用の認証情報を入力します。必要に応じて、MercadoPago アプリケーションで通知を設定します（設定を参照）。System > Localisation > Currencies でアカウントの通貨が有効になっているか確認します。

5. Enable / Disable をオンにして Save をクリックします。MercadoPago のテストカードを使用して、テストモードで支払いをテストし、その後 Test mode をオフにします。

OpenCart 4

1. 管理画面で Extensions > Installer に進み、Upload をクリックして、ファイル wcp_mercadopago_gateway.ocmod.zip を選択します。ファイル名は変更しないでください。OpenCart 4 は拡張機能のコードをファイル名から取得するため、名前を変更したパッケージは動作しません。

2. 同じページのインストール済み拡張機能の一覧にパッケージが表示されます。その横の Install（緑色の + ボタン）をクリックします。

3. Extensions > Extensions に進み、種類 Payments を選択します。VibeFox MercadoPago Gateway を見つけ、Install（緑色の + ボタン）をクリックしてから、Edit（鉛筆ボタン）をクリックします。

4. ライセンスキー、認証情報、通知を、OpenCart 3 の手順 3 から 5 と同じように入力します。設定ページとそのフィールドは両方のバージョンで同じです。異なるのは通知 URL だけです（支払い通知を参照）。

新規インストールでは、支払い方法はオフ、テストモードはオンの状態で開始します。

設定

すべての設定は拡張機能のページにあります: Extensions > Extensions > Payments > VibeFox MercadoPago Gateway > Edit。セクションは左側に一覧表示され、一覧の下にある Save ボタンでページ全体を保存します。設定の上には、テストモードがオンの間、Test mode is on: the TEST- credentials are used and no real money is charged. と表示されます。現在のモードの Public Key または Access Token が不足している場合（その場合、支払い方法はチェックアウトで非表示になります）、ストアの既定の通貨が MercadoPago アカウントの通貨と異なる場合（その場合、この支払い方法はアカウント通貨で支払うお客様にのみ表示されるか、ストアにその通貨が有効になっていなければ非表示になります）、認証情報が Account country と異なる国のアカウントに属している場合には、警告が表示されます。拡張機能を変更する権限がない場合、ページには設定は表示されますが、保存はできません。

Title を空の状態（または 128 文字を超える状態）で保存すると、何も保存されず、ページに Enter a title for the payment method (1 to 128 characters). と表示されます。それ以外の誤った値は保存されず、以前の値が維持されます。エラーには項目名が示され、— the previous value was kept. で終わります。これは、想定された接頭辞（テスト項目は TEST-、本番項目は APP_USR-）で始まらない認証情報、1〜24 の範囲外の Maximum installments、整数ではない Sort Order（Sort Order must be a whole number）、0 以上の数値ではない Total、存在しない地域ゾーンや注文ステータスに対して適用されます。保存後、拡張機能は MercadoPago に対して、各アクセストークンがどの国に属するかを問い合わせます。現在のモードのトークンを確認できない場合、アカウントが対応国にない場合、または国が Account country と異なる場合には、警告が表示されます。その場合、拡張機能はアカウントの国を使用します。

MercadoPago

Enable / Disable: Enable MercadoPago card payments で支払い方法のオン・オフを切り替えます。チェックアウトでこの支払い方法が表示されるのは、有効なモードの認証情報が入力され、お客様が MercadoPago アカウントの通貨で支払う場合のみです。既定値: オフ。

Title: チェックアウトでお客様に表示される支払い方法の名前です。注文にも支払い方法名として保存されます。既定値: Credit or debit card (MercadoPago)。必須、128 文字まで。

Description: Confirm Order の手順で、カード入力欄の上に表示されるテキストです。既定値: Pay securely with your credit or debit card. Card data is sent directly to MercadoPago.

Sort Order: チェックアウトにおける MercadoPago の支払い方法の表示順です。空欄のままにするか、整数を入力します。

Geo Zone: 選択した地域ゾーン内の支払い先住所に対してのみ MercadoPago を提供します。既定値: All zones。地域ゾーンは System > Localisation > Geo Zones で設定します。

Total: MercadoPago が提供されるために注文が達している必要がある、ストアの既定の通貨でのチェックアウト合計金額です。空欄にすると、どの金額でも MercadoPago を提供します。

MercadoPago アカウント

MercadoPago の開発者パネルで、アプリケーションの認証情報を取得します: Your integrations > your application > Credentials（ページからそこへのリンクがあります）。テスト用の認証情報は TEST- で、本番用の認証情報は APP_USR- で始まります。

Account country: MercadoPago アカウントの国です。請求通貨、カード入力欄の言語、カード名義人の書類を求めるかどうかを決定します。お客様は同じ通貨で支払う必要があります（例: アルゼンチンなら ARS）。認証情報を保存すると、国がアカウントと照合されます。既定値: Argentina (ARS)。

Argentina (ARS), Brazil (BRL), Chile (CLP), Colombia (COP), Mexico (MXN), Peru (PEN), Uruguay (UYU): 対応している国です。書類入力欄は、メキシコを除くすべての国で表示されます。

Test mode: テストモードでは TEST- の認証情報が使用され、MercadoPago のテストカードで支払いを行います。チェックアウトには TEST MODE のバッジと、Use MercadoPago test cards. No real charges. が表示されます。オフにすると、本番用の認証情報で実際のカードに請求します。返金と通知は、常に支払いが行われたモードの認証情報を使用します。既定値: オン。

Test Public Key: TEST- で始まります。ブラウザでカードをトークン化するために使用されます。

Test Access Token: TEST- で始まります。サーバーでのみ使用されます。秘密にしてください。

Production Public Key: APP_USR- で始まります。

Production Access Token: APP_USR- で始まります。サーバーでのみ使用されます。秘密にしてください。

保存されたアクセストークンと Webhook のシークレットは、再表示されません。入力欄は空のままになり、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。保存された値を削除するには、入力欄の下にある Clear the saved value on save にチェックを入れて、Save をクリックします。

支払いオプション

Maximum installments: お客様が選択できる分割払い（cuotas または parcelas）の最大回数で、1 から 24 までです。1 = 一括払いのみ。上限はサーバー側でも適用されます。既定値: 1。

支払い通知（Webhook）

カード支払いは通常、すぐに最終的な結果が得られます。MercadoPago が審査中（処理中または保留中）として保持する支払いは、MercadoPago の通知によって完了します。ストアが公開アドレスを持つ場合（localhost や .local、.test ドメインではない場合）、拡張機能は支払いごとに通知 URL を送信します。your application > Webhooks の Payments イベントに、この URL を追加することもできます。URL は、このセクションの Notification URL に表示されます。OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_mercadopago_gateway/webhook&source_news=webhooks、OpenCart 4 では https://your-store/index.php?route=extension/wcp_mercadopago_gateway/payment/wcp_mercadopago_gateway.webhook&source_news=webhooks で、OpenCart インストールのストアフロントのアドレスから作られます。設定に表示されたとおりに、URL を正確にコピーしてください。

通知がそれ自体で信頼されることはありません。拡張機能は、支払いが行われた環境のアクセストークンを使って MercadoPago API から支払い情報を読み直し、それをストア内の支払い試行に紐付けます。通知がない場合、審査中の注文は、手動で更新するまで Awaiting MercadoPago Status のままになります。

拡張機能は、次の MercadoPago の支払いステータスを処理します:

approved: 支払いが承認されました。金額と通貨が一致すると、注文は支払い済みになります。

in_process, pending, authorized: 支払いは審査中です。注文は Awaiting MercadoPago Status で待機し、後の通知によって完了します。

rejected, cancelled: 支払いが拒否またはキャンセルされました。新規の注文はステータスなしのままです。待機中の注文は Payment Failed Status になります。

refunded, charged_back, in_mediation: メモが追加されます。注文ステータスは変わりません。

Webhook secret signature: 任意です。your application > Webhooks に表示されるシークレット署名です。設定されている場合、有効な x-signature がない通知は拒否されます（HTTP 401）。

注文

OpenCart は Confirm Order の手順で、ステータスなし（未完了の注文）として注文を作成します。注文は MercadoPago が応答した後にのみステータスを得ます。カードが拒否された場合、注文はステータスなしのままになり（メモに理由が記録されます）、お客様は Confirm Order の手順にとどまります。以下の各項目には、OpenCart の注文ステータスが表示されます。

Order Status After Payment: MercadoPago が支払いを承認し、金額と通貨が注文と一致しています。既定値: 処理中。

Awaiting MercadoPago Status: 支払いは MercadoPago で審査中です（処理中または保留中）。通知によって注文が完了します。既定値: 保留中。

On Hold (Review) Status: MercadoPago が注文と異なる金額または通貨を承認したか、予期しないステータスを返しました。メモには、MercadoPago のパネルで確認すべき点が記されます。既定値: 保留中。OpenCart には On hold のステータスがないためです。待機中の注文と審査中の注文を区別するには、System > Localisation > Order Statuses で独自のステータスを作成できます。

Payment Failed Status: 審査中だった支払いが、MercadoPago によって拒否またはキャンセルされました。既定値: 失敗。

Cancelled Status: このステータス（または返金済みのステータス）の注文は終了しています。後から MercadoPago が承認しても、メモが追加されるだけです。既定値: キャンセル済み。

Refunded Status: 注文ページから支払いが全額返金された場合に設定されます。一部返金ではメモが追加されるだけです。既定値: 返金済み。

詳細設定

Debug log: MercadoPago のリクエストと通知を、OpenCart のログフォルダ（storage/logs）にある wc_mpg_debug.log.php に書き込みます。このファイルは Web から開くことはできません。エラーは、この設定がオフの間も常に記録されます。アクセストークン、カードトークン、支払者のデータは記録されません。既定値: オフ。

Log: ログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログを消去します。

Delete data on uninstall: オンにすると、拡張機能をアンインストールしたときにゲートウェイの設定とログが削除されます。MercadoPago の支払い記録と返金は常に残るため、再インストール後も、以前に支払われた注文を返金できます。既定値: オフ。

インポート / エクスポート

Export: Download JSON で、設定を JSON ファイルとして保存します。アクセストークンと Webhook のシークレットはエクスポートされません。

Import: 以前にエクスポートした JSON を貼り付けて、Import をクリックすると設定が復元されます。保存されている機密情報は保持されます。

チェックアウト

Payment Method の手順で、お客様は支払い方法を選びます（既定では Credit or debit card (MercadoPago)）。OpenCart は Confirm Order の手順で注文を作成しますが、まだステータスはありません。この画面で、お客様はあなたの説明文を確認し、カード入力欄に入力します: Card number、Expiry (MM/YY)、Security code、Cardholder name。国やカードによっては、お客様は Document type を選んで Document number を入力し、Card issuer と Installments の回数を選択する場合もあります。分割払いの選択肢と利息は、注文合計に対して MercadoPago から提供されます。

OpenCart 4 では、お客様は支払い方法ブロックの Choose ボタンで、Payment method options ウィンドウから支払い方法を選択します。その後、チェックアウトページ下部の注文確認ブロックに、Confirm Order ボタンの上のカード入力欄が表示されます。

お客様が Confirm Order をクリックすると、MercadoPago がカードを 1 回限りのトークンに変換し、ストアは注文通貨で注文合計額の支払いをサーバー上に作成します。お客様のメールアドレスと氏名、および書類は MercadoPago に渡されます。支払いは MercadoPago 上で Order #、注文番号、ストア名として表示されます。CLP と COP の金額は小数点なしで請求されます。

承認された支払いは、通常の OpenCart の方法で注文ステータスを設定し、通常の注文メールと在庫更新を行います。カートは空になり、お客様には OpenCart の注文完了ページが表示されます。審査中の支払いは Awaiting MercadoPago Status を設定し、ページには MercadoPago is reviewing your payment. Your order will be updated automatically as soon as MercadoPago confirms it. も表示されます。審査ステータスの注文には、Your payment is being reviewed. We will update your order as soon as the review is complete. と表示されます。

カードが拒否された場合、注文はステータスなしのままになります。お客様は、Your card has insufficient funds. Please use another card or payment method. や Please check the security code of your card. などの短い理由とともに Confirm Order の手順に残ります。お客様はデータを修正するか、別のカードを使用できます。試行ごとに新しいカードトークンが作成されます。カード情報が不足している場合は、Please fill in all card fields. と表示されます。

MercadoPago が応答しない場合、お客様には We could not confirm your payment with MercadoPago. Please wait a minute before trying again — if the payment went through, your order will be updated automatically. と表示されます。次の試行では、まず支払いを照会するため、カードが二重に請求されることはありません。カートの支払い処理中に 2 回目のクリックをすると、This order is already being paid. Please wait a moment and check your e-mail before trying again. と表示されます。OpenCart 3 は Confirm Order の手順が表示されるたびに新しい注文を作成し、OpenCart 4 はチェックアウトの注文を 1 つ保持して、カードが拒否された後はお客様が同じ注文を支払います。いずれの場合も、支払い済みまたは待機中の注文があるカートには二重に請求されることはなく、お客様は成功ページに案内されます。

OpenCart 4 は、成功ページが表示されるまで注文をチェックアウトに保持します。その注文が支払いなしで閉じられていた場合（たとえばストアがキャンセルした場合）、支払いは行われず、お客様には Your previous order was cancelled without a payment. Please reload the checkout page and confirm the order again — the payment will be made with a new order. が表示されます。注文がすでに確定していて、その後カートが変更されている場合、メッセージは Your previous order has already been placed. Your cart has changed since — please reload the checkout page and confirm the order again to pay for the current cart with a new order. です。数量の変更を含むカートの変更は、独自の支払いを必要とする新しいカートとして扱われます。

ストアがメンテナンスモードでも、通知 URL は機能します。OpenCart 3 は支払い拡張機能のリクエストを通過させ、OpenCart 4 では、拡張機能が通知のためのスタートアップアクションを追加します。

この拡張機能はクレジットカードとデビットカードのみに対応しています。Checkout Pro へのリダイレクト、MercadoPago のウォレットやアカウント残高、現金払い（Rapipago、OXXO、boleto など）、Pix、PSE、Yape、保存済みカードやサブスクリプション、個別の承認とキャプチャ、3-D Secure のチャレンジ、通貨換算には対応していません。

注文と返金

注文ステータス

No status (missing order): カードが拒否されたか、MercadoPago がまだ応答していません。Sales > Orders では、このような注文は Order Status フィルタを Missing Orders に設定した場合にのみ表示されます。

Order Status After Payment（既定値処理中）: MercadoPago が支払いを承認し、金額と通貨が注文と一致しています。メモには、支払い ID、環境、分割払いの回数が表示されます。

Awaiting MercadoPago Status（既定値保留中）: 支払いは審査中（処理中または保留中）で、MercadoPago の通知を待っています。MercadoPago が承認すると、注文は Order Status After Payment に移ります。

On Hold (Review) Status（既定値保留中）: 承認された金額または通貨が注文と異なるか、MercadoPago が予期しないステータスを返しました。メモにその理由が説明されます。注文を確認して処理するか、支払いを返金してください。

Payment Failed Status（既定値失敗）: 審査中の支払いが拒否またはキャンセルされました。メモには、ステータスとその詳細が表示されます。

Refunded Status（既定値返金済み）: 拡張機能を通じて支払いが全額返金されました。

すでにキャンセルまたは返金された注文について MercadoPago が支払いを承認した場合、ステータスは変わらず、メモで注文を完了するか支払いを返金するよう求められます。すでに支払い済みの注文またはカートに別の支払いが届いた場合、メモで MercadoPago のパネルから余分な支払いを返金するよう求められます。

メモは、お客様には表示されない注文の History のエントリです。

VibeFox MercadoPago Gateway タブ

Sales > Orders で、MercadoPago で支払われた注文を開きます。注文ページの下部、History と Additional の横に、VibeFox MercadoPago Gateway タブが表示され、Payment ID、支払いの Status、Environment（テスト支払いには Test のラベル）、Installments、Charged / order の金額、Refunded の金額、返金フォーム、返金履歴、注文の MercadoPago notes が表示されます。このタブは、拡張機能へのアクセス権があるユーザーに表示されます。

返金

VibeFox MercadoPago Gateway タブで、Amount（まだ返金されていない金額が自動入力されます）を入力し、必要に応じて Reason (optional) を入力して、Refund via MercadoPago をクリックします。Refund this amount through MercadoPago? This cannot be undone. という確認に同意してください。全額返金と一部返金に対応しています。拡張機能を変更する権限が必要です（System > Users > User Groups で設定します）。返金は MercadoPago が請求した金額に限られます。そのため、金額に差異があった場合は、注文合計ではなく、お客様が実際に支払った金額まで返金できます。返金は支払いが行われた環境（テストまたは本番）の認証情報で送信されるため、その環境のアクセストークンが設定されている必要があります。MercadoPago が返金を拒否すると、タブに理由とともに MercadoPago refused the refund が表示され、返金は記録されません。承認済みまたは処理中の返金は、返金 ID とともに返金履歴とメモに追加されます。全額返金では、お客様に通知せず、商品を在庫に戻すこともなく、手動でのステータス変更と同様に注文を Refunded Status にします。一部返金ではステータスは変わりません。

Sales > Returns での商品返品では、MercadoPago を通じて返金は行われません。

MercadoPago のパネルで行われた返金、チャージバック、調停は、通知によって届き、メモに追加されます。注文ステータスは自動では変わりません。必要に応じて手動で更新してください。

ライセンスキー

この拡張機能は、vibefox.net から取得した VibeFox ライセンスキーを使用します。ライセンスブロック License — VibeFox MercadoPago Gateway は、Extensions > Extensions > Payments > VibeFox MercadoPago Gateway > Edit ページで設定の上にある最初のブロックです。キーを License key に貼り付けて Activate をクリックします。その後、ブロックにはキーがマスクされた状態で表示され、ステータス（例: ライセンスの有効期限日とドメイン）と、次のボタンが表示されます: ステータスを再確認する Check now、別のキーを入力する Change key、このストアからキーを削除する Remove key。その下には Product: opencart-payment-mercadopago の行と、vibefox.net のアカウントを開く Manage licenses and domains in your account のリンクがあります。拡張機能に対する Modify 権限を持つ管理者ユーザーだけが、キーを変更できます。ブロックのテキストは管理画面の言語に従います（英語とロシア語が含まれています）。

キーが受け付けられない場合、ブロックにその理由が表示されます。例: Key not found、This key belongs to another product、Domain limit reached、または日付付きの License expired on。ストアのアドレスを変更した後、またはアカウントでドメインの枠を解放した後は、Check now をクリックしてください。ライセンスサーバーに接続できない場合、拡張機能は最後に確認されたステータスで動作を続けます。

1 つのキーは 1 つのドメインでのみ使用できます。ドメインとは、OpenCart の設定にあるストアのアドレスのことです。ストアからキーを削除しても、ドメインの枠は解放されません。枠は vibefox.net のアカウントで解放してください。

有効なキーがない場合、MercadoPago はチェックアウトでお客様に表示されません。それでも支払いが開始された場合、お客様には This payment method is not available. Please choose another one. と表示されます。同じブラウザで管理画面にログインしている管理者ユーザーには、ストアでこの支払い方法が (unlicensed — visible to admins only) と表示されたまま見えるため、キーを購入する前に拡張機能を設定してテストできます。OpenCart 4 ではこのプレビューは利用できません。ストアは管理者のログインを認識しないため、有効なキーがない場合、支払い方法は全員に対して非表示になります。Edit ページを一度開くと、管理画面の Dashboard にリマインダーが表示されます。× で閉じると、7 日間非表示になります。既存の注文には影響しません。すでに開始された支払いは引き続き確認され、返金も機能します。

ライセンスの有効期限が切れた場合も、拡張機能は動作を続けますが、アップデートとサポートには更新が必要です。ステータスは、管理画面の Dashboard または Edit ページを開いたときに自動的に再確認されます。キーを入力してから最初の 14 日間は 1 日 1 回、その後は週 1 回です。cron ジョブは不要です。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは常に削除されます。

トラブルシューティング

チェックアウトに MercadoPago が表示されない: ライセンスが有効であること、Enable / Disable がオンであること、現在のモードに正しい接頭辞の認証情報が 2 つそろっていることを確認してください。テストモードでは TEST- のキー、本番では APP_USR- のキーです。お客様が MercadoPago アカウントの通貨で支払っていること（その通貨がストアで有効になっている必要があります）、支払い先住所が選択された Geo Zone に含まれていること、注文が設定の Total に達していることも確認してください。設定ページには、不足している項目が表示されます。

支払いは完了したが、注文が Awaiting MercadoPago Status のまま: 通知が届いていません。拡張機能は、ストアに公開アドレスがある場合（localhost や .local、.test ドメインではない場合）にのみ通知 URL を送信します。Notification URL の URL を、your application > Webhooks に Payments イベントとともに追加してください。Webhook secret signature が設定されている場合は、同じアプリケーションのシークレットであることを確認してください。MercadoPago のパネルには、通知ごとにストアの応答が表示されます。

通知が invalid signature と応答する: シークレット署名が別のアプリケーションのものか、通知に有効な x-signature がありません。シークレットをもう一度コピーするか、フィールドを空にしてください。

通知が no credentials for test または no credentials for live と応答する: 支払いが行われた環境のアクセストークンが設定されていません。入力してください。MercadoPago は通知を再試行します。

通知が not for this store と応答する: この支払いは、このストアの支払い試行に属していません。注文は変更されません。

通知が order busy または payment could not be read と応答する: 同じ時点で別のリクエストによって注文が更新されていたか、MercadoPago に接続できませんでした。MercadoPago は通知を自動的に再試行します。

認証情報が保存されない: エラー must start with は、その項目に対して値の接頭辞が正しくないことを示します。テスト項目はテスト用の TEST- 認証情報を、本番項目は APP_USR- 認証情報を受け付けます。

お客様に「This payment method is not configured correctly. Please choose another payment method or contact the store.」と表示される: 現在のモードの認証情報が不足しているか、接頭辞が誤っているか、MercadoPago に拒否されています。設定ページで確認してください。

お客様に「MercadoPago cannot process payments in」と表示される: 注文の通貨が MercadoPago アカウントの通貨ではありません。MercadoPago は通貨換算を行いません。

安全なカードフォームが読み込まれない: お客様には The secure card form could not be loaded. Please reload the page or choose another payment method. が表示されます。現在のモードの Public Key を確認してください。

お客様に「Your session has expired. Please reload the page and try again.」と表示される: カードフォームは、もうお客様のチェックアウトセッションに属していません。お客様はチェックアウトページを再読み込みします。

お客様に「Your payment was received, but the order could not be completed automatically」と表示される: MercadoPago は支払いを受け付けましたが、OpenCart は注文ステータスを設定できませんでした。拡張機能ページの Log 欄を確認してください。エラーは常に記録されます。お客様には再度支払わないよう案内されます。カートに対する次の支払い試行または通知により、再請求なしでステータスが設定されます。

支払い後に注文が審査ステータスになっている: 注文のタブにある MercadoPago notes を読み（注文ステータスを参照）、注文を処理するか、支払いを返金してください。

モードに関するメッセージで返金に失敗する: 支払いはテストモードまたは本番モードで行われましたが、そのモードのアクセストークンが設定されていません。入力して、もう一度お試しください。

MercadoPago did not answer the refund request という理由で返金に失敗する: 再試行する前に、MercadoPago のパネルで支払いを確認してください。

アンインストール

Extensions > Extensions に進み、種類 Payments を選択して、VibeFox MercadoPago Gateway の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは、常に削除されます。OpenCart は、拡張機能自身の設定を常に削除します: Enable / Disable、Sort Order、Geo Zone、Total、および Orders セクションの注文ステータス。これらは再インストール時に既定値に戻ります。拡張機能の OpenCart イベントも削除されます（OpenCart 4 では、そのイベントと、メンテナンスモードで通知を通過させるスタートアップアクションも削除されます）。Delete data on uninstall がオンの場合、残りのゲートウェイ設定（タイトル、説明、アカウントの国、テストモード、認証情報、分割払い、Webhook のシークレット、ログ記録）、保存されたアカウント確認情報、ログが削除されます。オフの場合は、後で再インストールするために保持されます。MercadoPago の支払い記録と返金は常に残るため、再インストール後も、以前に支払われた注文を返金できます。既存の注文は、支払いのメモを保持します。

OpenCart 4 では、ファイルも削除するには、アンインストール後に Extensions > Installer に進み、インストール済み拡張機能の一覧で VibeFox MercadoPago Gateway の横の Uninstall（オレンジ色の − ボタン）をクリックしてから、Delete（赤いゴミ箱ボタン）をクリックして、アップロードされたパッケージを削除します。

MercadoPago は、それぞれの所有者の商標です。この拡張機能は MercadoPago と提携しておらず、MercadoPago による推奨も受けていません。