VibeFox Pagar.me for OpenCart — ヘルプ
要件
OpenCart: 3.0.x（3.0.5.0 で動作確認済み）または 4.0.2 以降（4.1.0.3 で動作確認済み）。
PHP: 8.0 以降。
Currency: ブラジル・レアル（BRL）。ストアに BRL 通貨が設定されている必要があり（System > Localisation > Currencies）、支払い方法は、購入者が BRL で注文し、注文合計が 0 より大きい場合にのみ表示されます。
Pagar.me account: Pagar.me アカウントのシークレットキーが必要です。テスト用キー（sk_test_...）と、本番稼働時に使用するライブキー（sk_...）です。これらは Pagar.me ダッシュボードの Development > Keys にあります。使用するのはシークレットキーのみで、公開キー（pk_...）は不要です。Pagar.me アカウントで有効になっている支払い方法のみを提供できます。
VibeFox license key: vibefox.net で購入できます。1 つのキーは 1 つのドメインで使用できます。
インストール
このダウンロードは、両方の OpenCart バージョン用パッケージを含む 1 つの zip ファイルです。コンピューターで解凍してください。中には README.txt、OpenCart 3 用パッケージ wcp_pagarme_gateway-oc3-(version).ocmod.zip、OpenCart 4 用パッケージ wcp_pagarme_gateway.ocmod.zip が含まれています。お使いの OpenCart のバージョンに合ったパッケージだけをインストールしてください。ライセンスキーは両バージョンで同じです。
OpenCart 3
1. 管理画面で Extensions > Installer を開き、Upload をクリックして、ファイル wcp_pagarme_gateway-oc3-(version).ocmod.zip を選択します。この拡張機能には OCMOD の変更が含まれないため、Extensions > Modifications を更新する必要はありません。インストーラーを使わず、このパッケージの upload フォルダーの内容をストアのルートフォルダーにコピーしても構いません。
2. Extensions > Extensions に移動し、種類 Payments を選択します。VibeFox Pagar.me Gateway を探し、Install（緑色の + ボタン）をクリックします。管理者ユーザーに、支払い系拡張機能の一覧を変更する権限が必要です。
3. Edit（鉛筆ボタン）をクリックして設定ページを開きます。ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを貼り付け、Activate をクリックします（ライセンスキーの項を参照）。
4. テスト用シークレットキーを入力し、本番稼働時にはライブ用シークレットキーを入力します。
5. 設定に表示されている URL を使って、Pagar.me ダッシュボードで webhook を作成します（設定の項を参照）。
6. Enable / Disable をオンにして、Save をクリックします。Test mode をオンにしたままテスト決済を行い、その後オフにして実際の決済を受け付けます。
OpenCart 4
1. 管理画面で Extensions > Installer を開き、Upload をクリックして、ファイル wcp_pagarme_gateway.ocmod.zip を選択します。ファイル名は変更しないでください。OpenCart 4 はファイル名から拡張機能のコードを取得するため、名前を変更したパッケージは動作しません。
2. インストール済みの拡張機能の一覧に、同じページでパッケージが表示されます。その横にある Install（緑色の + ボタン）をクリックします。
3. Extensions > Extensions に移動し、種類 Payments を選択します。VibeFox Pagar.me Gateway を探して Install（緑色の + ボタン）をクリックし、次に Edit（鉛筆ボタン）をクリックします。
4. ライセンスキー、シークレットキー、webhook は、OpenCart 3 の手順 3〜6 と同じように入力します。設定ページとそのフィールドは両バージョンで同じです。webhook の URL だけが異なります（決済通知（webhook）を参照）。
新規インストール時は、支払い方法がオフ、テストモードがオンの状態になります。
設定
すべての設定は拡張機能のページにあります：Extensions > Extensions > Payments > VibeFox Pagar.me Gateway > Edit。セクションは左側に一覧表示されます。一覧の下にある Save ボタンでページ全体が保存されます。設定の上には現在のモードが表示されます：TEST MODE（テスト用シークレットキーで決済が作成され、実際の請求は行われません）または LIVE。現在のモードのシークレットキーが未設定の場合（その場合、チェックアウトで支払い方法が非表示になります）、テストキーが sk_test_ で始まらない場合、ライブキーが sk_ で始まらないかテストキーである場合、ストアの既定通貨が BRL でない場合には警告が表示されます。拡張機能を変更する権限がない場合、ページには設定が表示されますが、保存はできません。
保存時、Title は空にできません（128 文字まで）。Boleto due in (days) は 1 から 30 までの整数である必要があります。Sort Order は整数である必要があります（負の数も可）。Total は 0 以上の数値である必要があり、ジオゾーンと注文ステータスが存在している必要があります。値が正しくない場合、エラーメッセージでその項目が示され、何も保存されません。
Pagar.me
Enable / Disable: Enable Pagar.me payments で支払い方法のオン／オフを切り替えます。既定値：オフ。
Title: チェックアウトで購入者に表示される支払い方法の名称です。注文に保存される支払い方法の名称にもなります。既定値：Pagar.me。必須、128 文字まで。
Description: Confirm Order のステップで、確認ボタンの上に購入者に表示されるテキストです。既定値：Pagar.me（クレジットカード、PIX、boleto）で安全にお支払いいただけます。お支払いを完了するため、決済ページへ移動します。
Sort Order: チェックアウトの支払い方法の中で Pagar.me が表示される位置です。空欄のままにするか、整数を入力してください。
Geo Zone: 選択したジオゾーン内の請求先住所に対してのみ Pagar.me を提供します。既定値：All zones。ジオゾーンは System > Localisation > Geo Zones で設定します。OpenCart 4 では、ストアで請求先住所が求められない場合、配送先住所が使用されます。
Total: Pagar.me を提供するために注文が達している必要がある、ストアの既定通貨でのチェックアウト合計です。空欄にすると、どの金額でも Pagar.me を提供します。
API キー
Pagar.me ダッシュボードからシークレットキーをコピーします（このセクションにはダッシュボードへのリンクがあります）：Development > Keys。Pagar.me はテスト決済とライブ決済で同じ API アドレスを使用します。決済がテストか実際のものかは、キーによって決まります。
Test mode: テスト用シークレットキーを使用し、実際の請求は行いません。オンの間、購入者は Confirm Order のステップで TEST MODE — Use test credentials. No real charges. と表示されます。注文のステータス確認や返金は、その決済が作成されたときのモードのキーを必ず使用します。既定値：オン。
Test secret key: Pagar.me のテスト用シークレットキー（sk_test_...）。テストモードがオンの間に使用されます。
Live secret key: Pagar.me のライブ用シークレットキー（sk_...）。テストモードがオフの間に使用されます。秘密にしてください。
保存済みのキーは二度と表示されません。フィールドは空のままになり、Saved — leave empty to keep it. と表示されます。変更する場合にのみ新しい値を入力してください。保存済みのキーを削除するには、フィールドの下にある Clear the saved key on save にチェックを入れ、Save をクリックします。
支払いページ
Pagar.me の支払いページで提供される方法で、それぞれに個別のスイッチがあります。Pagar.me アカウントで有効になっている方法のみを選択してください。何も選択されていない場合は、クレジットカード、PIX、boleto が提供されます。既定値：クレジットカード、PIX、boleto。
Boleto due in (days): boleto の支払期限までの日数（1 から 30）。既定値：3。これ以外の値を保存しようとすると、Boleto due in (days): enter a number from 1 to 30. と表示されて拒否されます。
決済通知（webhook）
Pagar.me ダッシュボードで Settings > Webhooks を開き、このセクションの Webhook URL に表示されている URL で webhook を作成します。OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_pagarme_gateway/webhook のような形式で、OpenCart 4 では https://your-store/index.php?route=extension/wcp_pagarme_gateway/payment/wcp_pagarme_gateway.webhook のような形式です。URL はOpenCart のインストール先のストアフロントのアドレスから作成されます。設定に表示されているとおりに正確にコピーしてください。URL はインターネットから到達可能である必要があります。
次のイベントを選択します（このセクションにも一覧があります）：
webhook にパスワードや署名は不要です。その内容は決して信頼されません。ストアが取得するのは Pagar.me の注文 ID のみで、その注文は作成されたモードのキーを使って Pagar.me API から読み込まれます。このストアで作成されていない Pagar.me の注文に関する通知は無視されます。webhook がない場合、後で行われた PIX や boleto の決済は、購入者がストアに戻ったときにのみ確認されます。
注文
OpenCart は Confirm Order のステップで、ステータスのない注文（欠落注文、missing order）を作成します。注文は、Pagar.me が webhook で決済を報告した後、または購入者がストアに戻った後にのみステータスを受け取ります。Pagar.me の注文は常に API から読み直されます。以下の各フィールドには、お使いの OpenCart の注文ステータスが一覧表示されます。
Order Status After Payment: Pagar.me の決済が確認された後に設定されるステータス。既定値：処理中。
Awaiting Pagar.me Payment Status: PIX コードまたは boleto が発行された、またはカード決済が審査中であることを示します。Pagar.me が後で入金を確認します。既定値：保留中。
Pagar.me Payment On Hold Status: 決済にお客様の確認が必要な状態です（注文ステータスを参照）。既定値：OpenCart に保留ステータスがないため、保留中。独自のステータスを System > Localisation > Order Statuses で作成し、ここで選択できます。
Payment Failed Status: 待機中の注文の決済が失敗した、キャンセルされた、または期限切れになったことを示します。Pagar.me が後で支払い済みと報告した場合、注文は支払い後のステータスになります。既定値：失敗。
Cancelled Order Status: ストアがキャンセルされた注文に使用するステータスです。拡張機能はこれを設定しません。この後に届いた Pagar.me の決済は、注文を審査ステータスにします。既定値：キャンセル済み。
Refunded Status: 注文ページまたは Pagar.me ダッシュボードで決済が全額返金された後に設定されます。既定値：返金済み。
詳細設定
Debug log: API リクエストと通知を、OpenCart のログフォルダー（storage/logs）にある wc_pgm_debug.log.php に書き込みます。このファイルはウェブから開くことはできません。エラーと警告は常に記録されます。キーや購入者データ（メールアドレス、電話番号、CPF）は記録されません。既定値：オフ。
Log: ログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログを空にできます。
Delete data on uninstall: オンにすると、拡張機能をアンインストールしたときに、ゲートウェイの設定とログが削除されます。注文と、その Pagar.me の決済データ（返金に必要）は常に保持されます。既定値：オフ。
インポート／エクスポート
Export: Download JSON で、設定を JSON ファイルとして保存します。シークレットキーはエクスポートされません。
Import: 以前にエクスポートした JSON を貼り付け、Import をクリックして設定を復元します。保存済みのシークレットキーは保持されます。
チェックアウト
Payment Method のステップで、購入者は支払い方法を選択します（既定では Pagar.me）。Confirm Order のステップでは、購入者にあなたの説明文と、You will be redirected to the Pagar.me payment page to pay by credit card, PIX, boleto or debit card. という注記が表示されます。OpenCart はこのステップで、まだステータスのない注文を作成します。OpenCart 4 では、購入者は支払い方法ブロックの Choose ボタンを使い、Payment method options ウィンドウで支払い方法を選択して、チェックアウトページ下部の Confirm Order をクリックします。購入者が Confirm Order をクリックすると、拡張機能は注文合計に基づいて BRL の Pagar.me 注文を作成し、購入者を Pagar.me の支払いページへ移動させます。税金、送料、その他の追加料金を含む注文明細は商品として送信されます。注文に割引（クーポン、ギフト券、ポイント）がある場合、または明細の合計が注文総額と一致しない場合は、注文番号を含む Order # という 1 行が総額として送信されます。有効なメールアドレスが必要です。
購入者の氏名とメールアドレスは Pagar.me に渡されます。CPF または CNPJ（11 桁または 14 桁）は、名前に CPF または CNPJ を含む、購入者またはお支払い先住所のカスタムフィールドから取得されます。OpenCart には既定でそのようなフィールドがないため、渡したい場合は Customers > Custom Fields で追加してください。OpenCart 4 では、ストアで請求先住所が求められない場合、配送先住所とそのカスタムフィールドが使用されます。ブラジルの携帯電話番号も渡されます。請求先住所は、8 桁の CEP と州を含むブラジルの住所の場合にのみ渡されます。CPF または CNPJ がない場合は、購入者が Pagar.me の支払いページで入力します。
支払い後、購入者はストアに戻ります。注文は、Pagar.me が確認した後にのみ支払い済みとしてマークされます。ストアは API から Pagar.me の注文を読み込み、支払われた金額と通貨が注文と一致している必要があります。その後、注文は通常の OpenCart の方法でステータスを受け取り、通常の注文メールと在庫の更新が行われ、購入者には OpenCart の注文完了ページが表示されます。発行されたがまだ支払われていない PIX や boleto は、注文を待機ステータスにし、ページには Your Pagar.me payment is awaiting confirmation (PIX / boleto). The order will be confirmed as soon as Pagar.me reports the payment. も表示されます。審査ステータスの注文には We are confirming your payment with Pagar.me. The order will be updated automatically — please do not pay again. と表示されます。その後の戻りのたびに Pagar.me の注文が再度読み込まれるため、webhook が届かなくても、その間に支払われた PIX や boleto は反映されます。
購入者が支払わずに戻った場合、チェックアウトに戻り、The Pagar.me payment was not completed. You can try again or choose another payment method. と表示されます。支払いが拒否された、またはキャンセルされた場合、メッセージは The Pagar.me payment was declined or canceled. You can try again or choose another payment method. になります。カートは保持されます。OpenCart 4 では、これらのメッセージはチェックアウトページの上部に表示されます。注文にすでにステータスがあり、その決済が失敗または期限切れになった場合、メッセージは The Pagar.me payment of your order was declined, canceled or has expired. Please place a new order or contact us. になります。カートがすでに空の場合（例：PIX や boleto の期限切れの前に、注文が完了ページに到達していた場合）、チェックアウトで支払うものはありません。Payment confirmation のページには The Pagar.me payment of order #N was not completed (declined, canceled or expired), so the order will not be shipped. To buy these items, please place a new order. と表示され、Continue ボタンが表示されます。Pagar.me に接続できない場合、Payment confirmation のページで、購入者に再度支払わないよう求め、Check again と Back to checkout を表示します。
OpenCart 3 は、Confirm Order のステップが表示されるたびに新しい注文を作成します。OpenCart 4 はチェックアウトの注文を 1 つ保持して更新するため、未完了または拒否された決済の後も、購入者は同じ注文に対して再度支払います。新しい支払いの前に、拡張機能は同じカートの過去の試行を確認します。その中のいずれかが支払い済み、または PIX や boleto が支払いを待っている場合、購入者は新たに支払うことなく完了ページに進みます。同じ注文で開いたままの Pagar.me の支払いページは、金額とモードが同じであれば再利用されます。その他の開いたページは、先に Pagar.me 上で閉じられます。同じカートの 2 つ目の Pagar.me 注文が支払われてしまった場合、それは反映されず、支払い済みの注文に付くメモで重複分の返金を依頼されます。
OpenCart 4 では、成功ページが表示されるまで注文はチェックアウト内に保持されます。その間に注文が閉じられた場合（例：PIX や boleto の期限切れ、決済の失敗、またはご自身によるキャンセルや返金）、Confirm Order は購入者を Your previous order was cancelled or its payment failed. Please confirm the order again. とともにチェックアウトに戻します。注文を閉じる前にすでに支払い済みだった場合は、This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. と表示されます。次の Confirm Order では新しい注文の支払いが行われます。購入者が、支払い済みの後にご自身が閉じた注文から Pagar.me 経由で戻った場合、チェックアウトで同じメッセージが表示されます。カートがすでに空の場合は、Order #（番号） was closed by the store, so it will not be shipped. To buy these items, please place a new order. と表示されるページになります。チェックアウトの注文にすでにステータスがあり、カートに他の商品や数量がある場合、購入者はチェックアウトに戻され、新しいカートには新しい注文が作られます。
Pagar.me が支払いを開始できない場合、購入者は Confirm Order のステップに留まり、Could not connect to Pagar.me. Please try again in a moment. などの短いメッセージや、請求先情報が無効であるという Pagar.me のメッセージが表示されます。技術的な原因はログに記録されます。
ストアがメンテナンスモードの間でも、webhook は動作します。OpenCart 3 では決済拡張機能のリクエストが通過し、OpenCart 4 では拡張機能が webhook と購入者が Pagar.me から戻る際のリクエストを通すスタートアップアクションを追加します。
この拡張機能は、チェックアウト内にカード入力フォームを持たず、保存済みカード、サブスクリプションや定期払い、分割払いのルール、分割決済（マーケットプレイス）、オーソリのみのカード決済には対応していません。
注文と返金
注文ステータス
No status (missing order): 購入者は Pagar.me に移動しましたが、まだ支払いや PIX・boleto の発行を行っていない、または支払いが拒否されました。Sales > Orders では、そうした注文は Order Status フィルターを Missing Orders に設定した場合にのみ表示されます。
OpenCart 4 では、未払いのチェックアウト注文に Voided というステータスが付くことがあります。これは、購入者が Confirm Order のステップに戻ったときに OpenCart 4 が設定するものです。拡張機能はそのような注文をステータスなしの注文として扱い、後で行われた決済でも確認します。
Order Status After Payment (default Processing): 決済が確認されました。メモには Pagar.me の注文 ID（or_...）と支払い方法が表示されます。
Awaiting Pagar.me Payment Status (default Pending): PIX または boleto が発行された（またはカード決済が審査中である）状態で、支払いを待っています。Pagar.me が決済を確認すると、注文は Order Status After Payment に移ります。
Pagar.me Payment On Hold Status (default Pending): boleto が一部しか支払われなかった、支払われた金額または通貨が注文と異なる、注文がキャンセルまたは返金された後に決済が届いた、または支払い済みの注文にチャージバックが発生した、といった状態です。メモで理由が説明されます。注文を確認して処理するか、決済を返金してください。
Payment Failed Status (default Failed): 待機中または保留中の注文の決済が失敗した、または Pagar.me の注文がキャンセルされた、もしくは期限切れになった状態です（例：未払いの boleto）。Pagar.me が後で決済を報告した場合でも、注文は Order Status After Payment に移ります。
Refunded Status (default Refunded): 決済が拡張機能を通じて全額返金された、または Pagar.me で返金またはキャンセルされたことを示します。
各 Pagar.me ステータスは 1 回だけ適用されるため、webhook や戻りが繰り返されてもメモや決済が追加されることはありません。メモは注文の History に記録されるエントリで、購入者には表示されません。
VibeFox Pagar.me Gateway タブ
Sales > Orders で、Pagar.me で支払われた注文を開きます。注文ページの下部、History と Additional の隣に、VibeFox Pagar.me Gateway タブが表示されます。このタブには、Pagar.me order の ID（テスト決済には Test mode ラベル付き）、Payment method、Status、Paid / refunded の金額、返金フォーム、返金履歴、その注文の Pagar.me notes が表示されます。このタブは、拡張機能へのアクセス権を持つユーザーに表示されます。
返金
VibeFox Pagar.me Gateway タブで Amount を入力します（まだ返金されていない金額が自動入力されます）。必要に応じて Reason (optional) を入力し、Refund via Pagar.me をクリックします。Refund this amount through Pagar.me? This cannot be undone. の確認に応答してください。カードと PIX の決済については、全額返金と一部返金に対応しています。拡張機能を変更する権限が必要です（System > Users > User Groups で設定）。返金できるのは、Pagar.me が実際に請求した金額までです。そのため、金額に食い違いがあった場合の上限は注文合計ではなく、購入者が実際に支払った金額になります。返金は、決済が行われたモードのキーで送信されるため、そのモードのシークレットキーが設定されている必要があります。返金は Pagar.me が確認した場合にのみ記録されます。確認されなかった場合、タブには Pagar.me refused the refund: ... や Pagar.me did not confirm the refund などのエラーが表示され、返金は記録されません。成功した返金は、請求 ID と共に返金履歴とメモに追加されます。全額返金を行うと、注文は購入者に通知されることなく Refunded Status になり、商品は在庫に戻されません（手動でステータスを変更した場合と同じです）。一部返金ではステータスは変わりません。返金は、Pagar.me が決済を報告した後に利用できます。
boleto の決済は、購入者の銀行口座にしか返金できません。Pagar.me ダッシュボードで返金し、その後 OpenCart で返金を手動で記録してください。Sales > Returns での商品返品では、Pagar.me を通じて返金は行われません。
Pagar.me ダッシュボードで行われた全額返金またはキャンセルは webhook で届き、注文を Refunded Status に設定し、メモを追加します。チャージバックはメモを追加し、支払い済みの注文を審査ステータスにします。
ライセンスキー
この拡張機能は、vibefox.net で取得した VibeFox ライセンスキーで動作します。License — VibeFox Pagar.me Gateway のライセンスブロックは、Extensions > Extensions > Payments > VibeFox Pagar.me Gateway > Edit ページの最初のブロックで、設定の上にあります。License key にキーを貼り付け、Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス（例：ライセンスが有効な期限日とお使いのドメイン）、そして次のボタンが表示されます：ステータスを再確認する Check now、別のキーを入力する Change key、このストアからキーを削除する Remove key。その下には Product: opencart-payment-pagarme の行と、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 のアカウントで解放してください。
有効なキーがない場合、チェックアウトで購入者に Pagar.me は表示されません。それでも決済が開始された場合、購入者には 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 ジョブは必要ありません。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
Pagar.me does not appear at checkout: ライセンスが有効であること、Enable / Disable がオンであること、現在のモードのシークレットキーが設定されていること（テストモードでは Test secret key、ライブモードでは Live secret key）、そして購入者が BRL でチェックアウトしていることを確認してください。キーがない場合、設定ページに警告が表示されます。また、支払い先住所が選択した Geo Zone に含まれていること、注文が設定の Total に達していることも確認してください。
The payment went through, but the order stays without a status or in the awaiting status: webhook が機能していません。Pagar.me ダッシュボードで、使用しているアカウントとモードの webhook が存在すること、その URL が Webhook URL に表示されているものと正確に一致すること、そして上に記載されたイベントが選択されていることを確認してください。注文は、購入者がストアに戻るたびにも確認されます。
The webhook answers verification failed, retry later: ストアは API から Pagar.me の注文を読み込めませんでした。例えば、そのモードのキーがない、または API が応答しなかった場合です。Pagar.me は webhook を再試行します。
The webhook answers busy: 同じ瞬間に、別のリクエストによってカートが処理されていた、または注文ステータスを設定できなかった場合です。Pagar.me は webhook を再試行します。理由を確認するには Debug log をオンにしてください。
The webhook answers unknown order: その Pagar.me の注文は、このストアで作成されたものではありません（例：同じアカウント上の別のストアの注文）。何も変更されません。
The webhook answers invalid payload or invalid order id: そのリクエストは Pagar.me からの通知ではありません。何も変更されません。
The customer sees Pagar.me payments are not available right now: シークレットキーが間違っているか、存在しません。現在のモードのキーを確認してください。
The customer sees Pagar.me could not start the payment: Pagar.me が請求先情報を拒否しました（例：カスタムフィールドの CPF）。メッセージには問題が示されます。詳しい理由はログに記録されています。
The customer sees A valid billing email is required for Pagar.me.: 注文のメールアドレスが有効ではありません。
The customer sees Pagar.me only supports payments in Brazilian Real (BRL).: チェックアウトが別の通貨になっています。
The customer sees This order already has a Pagar.me payment that the store has to review: そのカートの以前の決済について、お客様による確認が必要です。Pagar.me ダッシュボードとログを確認してください。
Order is in the review status after payment: VibeFox Pagar.me Gateway タブのメモを確認し（注文ステータスを参照）、その後注文を処理するか、決済を返金してください。
No refund form in the tab: タブに理由が表示されます。決済がまだ報告されていない、全額返金済みである、ユーザーグループに拡張機能を変更する権限がない、または決済のモードのシークレットキーが設定されていない、のいずれかです。
Refund fails for a boleto: boleto の決済は API 経由で返金できません。Pagar.me ダッシュボードで返金し、手動で記録してください。
開発者向け：Pagar.me の注文を送信する前に、拡張機能は OpenCart イベント wc_pgm_order_data を、リクエスト本文と注文とともに発行します。決済金額は注文合計と同じに保つ必要があります。
アンインストール
Extensions > Extensions に移動し、種類 Payments を選択して、VibeFox Pagar.me Gateway の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは、常に削除されます。OpenCart は、拡張機能自身の設定を常に削除します：Enable / Disable、Sort Order、Geo Zone、Total、そして Orders セクションの注文ステータス。これらは再インストール時に既定値に戻ります。拡張機能の OpenCart イベントも削除されます（OpenCart 4 では、イベントと、メンテナンスモードでも webhook と購入者の戻りを通すスタートアップアクションも削除されます）。Delete data on uninstall がオンの場合、ゲートウェイのその他の設定（タイトル、説明、テストモード、シークレットキー、支払い方法、boleto の日数、ログ記録）とログが削除されます。オフの場合は、後で再インストールするために保持されます。Pagar.me の決済記録と返金記録は常に保持されるため、以前に支払われた注文は、再インストール後も返金できます。既存の注文は、決済のメモを保持します。
OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer を開き、インストール済み拡張機能の一覧で VibeFox Pagar.me Gateway の横にある Uninstall（オレンジ色の − ボタン）をクリックし、その後、アップロードしたパッケージを削除するために Delete（赤いゴミ箱のボタン）をクリックします。
Pagar.me は各所有者の商標です。本拡張機能は Pagar.me と提携しておらず、Pagar.me による推奨も受けていません。