VibeFox GMO for OpenCart — ヘルプ
要件
OpenCart: 3.0.x（3.0.5.0 でテスト済み）または 4.0.2 以降（4.1.0.3 でテスト済み）。
PHP: 8.0 以降。
通貨: 日本円（JPY）。GMO-PG は円でのみ請求するため、購入者のチェックアウト通貨が JPY の場合にのみ決済方法が表示されます。貴店にまだ JPY がない場合は、System > Localisation > Currencies で追加してください。金額は、注文合計をストアの JPY レートで換算し、整数の円に丸めたものです。
GMO Payment Gateway アカウント: Link Type Plus を含む GMO-PG の加盟店契約。テスト環境および/または本番環境の Shop ID、Shop password、Link Type Plus Config ID（設定ID）が必要です。また、GMO-PG のショップコンソールで結果通知（結果通知）を有効にしておく必要があります（Configuration を参照）。Site ID と Site password は使用しません。
VibeFox ライセンスキー: vibefox.net で購入します。1 つのキーは 1 つのドメインで使用できます。
インストール
このダウンロードは、両方の OpenCart バージョン用のパッケージを含む 1 つの zip ファイルです。コンピューターで解凍してください。README.txt、OpenCart 3 用のパッケージ wcp_gmo_payment-oc3-(version).ocmod.zip、OpenCart 4 用のパッケージ wcp_gmo_payment.ocmod.zip が含まれています。お使いの OpenCart バージョン用のパッケージのみをインストールしてください。ライセンスキーは両方のバージョンで同じです。
OpenCart 3
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル wcp_gmo_payment-oc3-(version).ocmod.zip を選択します。この拡張機能には OCMOD の変更がないため、Extensions > Modifications を更新する必要はありません。インストーラーを使う代わりに、このパッケージの upload フォルダの内容をストアのルートフォルダにコピーすることもできます。
2. Extensions > Extensions に移動し、種類 Payments を選択します。VibeFox GMO Payment Gateway を見つけて、Install（緑色の + ボタン）をクリックします。管理者ユーザーには、決済拡張機能の一覧を変更する権限が必要です。
3. Edit（鉛筆のボタン）をクリックして設定ページを開きます。ページ上部のライセンスブロックにある License key に VibeFox ライセンスキーを貼り付け、Activate をクリックします（License key を参照）。
4. テスト環境および/または本番環境の Shop ID、Shop password、Config ID を入力し、Environment を選択します。
5. GMO-PG のショップコンソールで結果通知（result notification）を有効にし、設定に表示される通知 URL を登録します（Configuration を参照）。
6. Enable/Disable をオンにして Save をクリックします。テスト環境でテスト決済を行い、その後 Environment を本番に切り替えます。
OpenCart 4
1. 管理画面で Extensions > Installer に移動し、Upload をクリックして、ファイル wcp_gmo_payment.ocmod.zip を選択します。ファイル名を変更しないでください。OpenCart 4 は、ファイル名から拡張機能のコードを取得するため、名前を変更したパッケージは動作しません。
2. インストール済み拡張機能の一覧の同じページに、パッケージが表示されます。その横の Install（緑色の + ボタン）をクリックします。
3. Extensions > Extensions に移動し、種類 Payments を選択します。VibeFox GMO Payment Gateway を見つけ、Install（緑色の + ボタン）をクリックしてから、Edit（鉛筆のボタン）をクリックします。
4. OpenCart 3 の手順 3〜6 と同じように、ライセンスキー、GMO-PG の認証情報、通知 URL を入力します。設定ページとそのフィールドは両方のバージョンで同じです。異なるのは通知 URL だけです（決済通知（結果通知）を参照）。
新規インストール時は、決済方法がオフで、テスト環境が選択された状態になります。
設定
すべての設定は拡張機能のページにあります：Extensions > Extensions > Payments > VibeFox GMO Payment Gateway > Edit。セクションは左側に並んでおり、一覧の下にある Save ボタンでページ全体を保存します。設定の上部には、ストアの既定通貨が JPY でない場合や、現在の環境の Shop ID、Shop password、Config ID が未入力の場合に警告が表示されます（その場合、決済方法はチェックアウトで非表示になります）。また、有効な環境も表示されます：TEST — payments go to pt01.mul-pay.jp with the test credentials, no real money is charged. または PRODUCTION — payments go to p01.mul-pay.jp. 拡張機能を変更する権限がない場合、ページには設定は表示されますが、保存はできません。
保存時に、Title は 1〜128 文字、Sort Order は空欄または整数、Total は空欄または 0 以上の数値である必要があり、すべての注文ステータスが存在している必要があります。問題がある場合は何も保存されず、ページにエラーが一覧表示されます。認証情報の前後の空白は削除されます。
GMO Payment Gateway — クレジットカード
Enable/Disable: Enable GMO Payment Gateway — Credit Card で決済方法のオン/オフを切り替えます。初期値: オフ。
Title: 購入者がチェックアウトで見る決済方法の名称です。注文に保存される決済方法の名称にもなります。初期値: Credit card。必須、128 文字まで。
Description: Confirm Order のステップで、確認ボタンの上に表示される決済方法の説明です。初期値: You will be redirected to the secure GMO Payment Gateway page to pay by credit card.
Sort Order: チェックアウトでの決済方法の表示順です。空欄のままにするか、整数を入力してください。
Geo Zone: 選択したジオゾーン内の支払い住所に対してのみ決済方法を提供します。初期値: All zones。ジオゾーンは System > Localisation > Geo Zones で設定します。
Total: 決済方法を提供するために注文が達している必要がある、ストアの既定通貨でのチェックアウト合計金額です。空欄にすると、どの金額でも提供されます。
GMO-PG アカウント
Shop ID と Shop password は GMO-PG のショップコンソールの Shop management > Shop information にあり、Config ID は Link Type Plus > Settings（設定ID）にあります。テスト環境と本番環境では認証情報が異なります。
Environment: 新しい決済を受け付ける GMO-PG の環境です。
Production Shop ID: 本番環境の Shop ID です。
Production Shop password: 本番環境の Shop password です。
Production Config ID: GMO-PG のコンソールに登録されている Link Type Plus の config ID（設定ID）です。
Test Shop ID: テスト環境の Shop ID です。
Test Shop password: テスト環境の Shop password です。
Test Config ID: テスト環境の Link Type Plus の config ID（設定ID）です。
保存済みのパスワードは二度と表示されません。フィールドは空欄のままで、Saved — leave empty to keep it. と表示されます。変更する場合のみ新しい値を入力してください。保存済みのパスワードを削除するには、フィールドの下の Clear the saved password on save にチェックを入れ、Save をクリックします。
決済
Capture: カードへの請求のタイミングです。
Order status after payment: 支払い済みの注文に設定されるステータスです。
決済通知（結果通知）
結果通知は、決済が行われたことを貴店に知らせるものです。必須です。GMO-PG のショップコンソールで結果通知（result notification）を有効にし、このセクションの Notification URL に表示される URL を設定してください。OpenCart 3 では https://your-store/index.php?route=extension/payment/wcp_gmo_payment/notify のような形で、OpenCart 4 では https://your-store/index.php?route=extension/wcp_gmo_payment/payment/wcp_gmo_payment.notify のような形になります。URL は OpenCart のストアフロントのアドレスから組み立てられます。設定に表示されたとおりに URL をコピーしてください。URL はインターネットから到達可能である必要があります。メンテナンスモードでも遮断されません。
GMO-PG の通知には署名がないため、拡張機能は通知の内容を決して信頼しません。通知は設定済みの Shop ID のいずれかから届き、決済が行われた環境で、このストアが作成した決済を参照している必要があります。その上で拡張機能は、Shop password を使って GMO-PG に取引を照会（SearchTrade）し、その回答に基づいてのみ注文を変更します。実際の取引と一致しない通知では何も変わりません。ストアが作成していない取引（例: GMO-PG のコンソールで行われた取引）は確認されたうえで無視されます。拡張機能が通知を検証できない場合は、GMO-PG が再送するような応答を返します。
通知がない場合、注文は購入者が決済後にストアに戻ったときにのみステータスを受け取ります。
注文ステータス
OpenCart は Confirm Order のステップで、ステータスなし（欠落注文、missing order）として注文を作成します。注文がステータスを受け取るのは、GMO-PG が決済を確認した後だけです。各フィールドには、貴店の OpenCart の注文ステータスが一覧表示されます。OpenCart には On hold ステータスがないため、承認のみの決済や金額が異なる決済は、下記の保留ステータスと注文メモを受け取ります。
Processing: Order status after payment が処理中である場合の、支払い済みの注文です。初期値: 処理中。
Completed: Order status after payment が完了である場合の、支払い済みの注文です。初期値: 完了。
GMO-PG payment on hold: 承認のみ（キャプチャ待ち）、または金額が注文と一致しない場合です。初期値: 保留中。System > Localisation > Order Statuses で独自のステータスを作成し、ここで選択できます。
Cancelled: GMO-PG で取り消された承認または保留中の決済、あるいは全額返金された承認です。初期値: キャンセル。
Refunded: 注文ページから全額返金された後です。初期値: 返金済み。
詳細設定
Debug log: API リクエストと通知を、OpenCart のログフォルダ（storage/logs）にある gmo_pg_debug.log.php に書き込みます。ファイルはウェブから開くことはできず、5 MB に達するとローテーションされます。エラーと警告は、スイッチがオフでも常に記録されます。パスワードと購入者データはマスクされます。初期値: オフ。
Log: ログのサイズと最新のエントリを表示します。Clear log をクリックすると、ログが空になります。
Delete data on uninstall: オンにすると、拡張機能のアンインストール時にゲートウェイの設定とログが削除されます。注文データ（GMO OrderID、トランザクション ID）は常に保持されます。初期値: オフ。
インポート / エクスポート
Export: Download JSON で、設定を JSON ファイルとして保存します。ショップのパスワードはエクスポートされません。
Import: 以前にエクスポートした JSON を貼り付け、Import をクリックして設定を復元します。保存済みのショップパスワードは保持されます。
チェックアウト
Payment Method のステップで、購入者は決済方法を選択します（初期値は Credit card）。Confirm Order のステップでは、購入者に貴店の説明が表示されます。テスト環境では、その上に TEST — GMO-PG test environment, no real charges. のバッジが表示されます。OpenCart は、このステップで注文を作成しますが、まだステータスはありません。OpenCart 4 では、購入者は決済方法ブロックの Choose ボタンを使い、Payment method options ウィンドウで決済方法を選んでから、チェックアウトページ下部の Confirm Order をクリックします。購入者が Confirm Order をクリックすると、拡張機能は注文合計を整数の円で GMO-PG Link Type Plus の決済として作成し、購入者を GMO-PG の決済ページに移動させます。そこで購入者はクレジットカードで支払います。3-D Secure 2.0 は GMO-PG が処理し、3-D Secure のために購入者のメールアドレスが GMO-PG に渡されます。決済ページは注文の言語に応じて、日本語、中国語、英語で開きます。GMO-PG 上の決済には OC- と注文番号が表示されます。それ以外の購入者データは送信されません。
決済後、購入者は貴店に戻ります。署名された結果は、決済が行われた環境の Shop password で検証され、注文は GMO-PG が確認した後にのみ支払い済みになります。購入者が戻ったときのサーバー側の SearchTrade リクエストによる確認か、結果通知による確認のいずれかです。どちらの方法も同じロジックを使うため、決済が二重に適用されることはありません。その後、注文は OpenCart の標準的な方法でステータスを受け取り、通常の注文メールと在庫の更新が行われ、購入者には OpenCart の注文完了ページが表示されます。GMO-PG がまだ決済を確認していない場合は、Payment confirmation ページに Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed. と表示され、Check again と Back to checkout のボタンが表示されます。通知が届いた時点で、注文ステータスが設定されます。
カードが拒否された場合、または GMO-PG のページで決済に失敗した場合、購入者は The card payment was declined or could not be completed. Please try again or use another card. と表示されたチェックアウトに戻ります。購入者が決済せずに GMO-PG のページを離れた場合は、The payment was not completed. You can try again or choose another payment method. と表示されます。カートは保持されます。OpenCart 4 では、これらのメッセージはチェックアウトページの上部に表示されます。新しい試行のたびに（OpenCart 3 では Confirm Order のステップが表示されるたびに新しい注文が作成され、OpenCart 4 ではチェックアウトの注文が更新されます）、カートの以前の未払いの決済リンクは取り消されます。その間に以前のリンクが支払われていた場合は、その決済が確認され、新しいリンクは作成されません。
OpenCart 4 は、成功ページが表示されるまで注文をチェックアウトに保持します。その間に決済されずに注文が閉じられた場合（たとえば GMO-PG でキャンセルされた場合、または管理者によってキャンセルされた場合）、購入者は Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. と表示されたチェックアウトに戻され、次の Confirm Order で、カートの新しい注文に対して決済が行われます。その注文がすでに支払い済みでも、数量の変更を含めてカートがその後変わっている場合は、Your previous order has already been placed. Your cart has changed since — please confirm the order again to pay for the current cart with a new order. と表示されます。支払い済みの注文が、別のカートについて支払い済みとして表示されることは決してありません。
注文合計が 1〜9,999,999 JPY の場合は決済できます。これより大きい場合は、決済方法は非表示になります。決済を開始できない場合、購入者は Confirm Order のステップにとどまり、ボタンの上に短いメッセージが表示されます（例: Card payment could not be started. Please try again or choose another payment method.）。理由はログに記録されます。
ストアがメンテナンスモードの間も、通知と戻りは機能します。これは、OpenCart 3 が決済拡張機能のリクエストを通過させ、OpenCart 4 では拡張機能がそのための起動時アクションを追加するからです。
この拡張機能は、クレジットカード決済を JPY でのみ、常に GMO-PG のページで受け付けます。その他の GMO-PG の決済方法、複数通貨、保存済みカード、GMO-PG の会員登録、サブスクリプションや定期請求、サイト上のカード入力フォームには対応していません。
注文と返金
注文ステータス
No status (missing order): 購入者は GMO-PG に送られたものの、まだ決済していないか、GMO-PG がまだ決済を確認していません。Sales > Orders では、このような注文は Order Status フィルターを Missing Orders に設定した場合にのみ表示されます。
Processing or Completed status: 決済が確認されました。ステータスは Order status after payment に従います。メモには、金額、GMO-PG のステータス、トランザクション、確認方法（通知または戻り）が表示されます。
GMO-PG payment on hold (authorized): Authorize only (仮売上) の場合、金額は承認されています。承認の期限が切れる前に、Capture payment (GMO-PG) または GMO-PG のコンソールでキャプチャしてください。キャプチャ後、注文は支払い済みステータスになります。承認が GMO-PG で取り消された場合、注文は Cancelled ステータスになります。
GMO-PG payment on hold after payment: GMO-PG が報告した金額が注文合計と異なります。メモに理由が説明されています。注文を確認して処理するか、決済を返金してください。
Refunded: 決済は拡張機能を通じて全額返金されました。一度もキャプチャされていない承認の全額返金は、Cancelled ステータスになります。
すでに支払い済みの注文に対して 2 回目の決済が届いた場合、または同じカートの別の注文が支払われた場合、支払い済みの注文は変更されません。メモで、重複した決済を GMO-PG のコンソールから返金するよう求められます。GMO-PG の決済がないままステータスが設定されている注文に決済が届いた場合は、メモが追加されるだけです。
メモは、購入者には表示されない注文の History の項目です。
VibeFox GMO Payment Gateway タブ
Sales > Orders で、GMO-PG で支払われた注文を開きます。注文ページの下部、History と Additional の横に、VibeFox GMO Payment Gateway タブが表示されます。このタブには、GMO OrderID（テスト決済には TEST ラベル付き）、Transaction ID、GMO-PG のステータスを含む Status、Paid / refunded、キャプチャボタンと返金フォーム、返金履歴、注文の GMO-PG notes が表示されます。このタブは、拡張機能にアクセスできるユーザーに表示されます。キャプチャと返金には、拡張機能を変更する権限が必要です（System > Users > User Groups で設定）。
キャプチャ
Capture payment (GMO-PG) は、承認のみで保留中の注文のタブに表示されます。Capture the authorized GMO-PG payment? を確認してください。拡張機能は GMO-PG で取引を確認し、承認された金額を請求します。その後、注文は支払い済みステータスになります。取引がもう承認されていない場合（たとえば GMO-PG のコンソールですでにキャプチャされている場合）は、メッセージに現在のステータスが表示されます。GMO-PG のコンソールで行われたキャプチャは、結果通知によって反映されます。
返金
タブで Amount を入力します（まだ返金されていない金額が自動的に入力されます）。必要に応じて Reason (optional) も入力し、Refund via GMO-PG をクリックします。Refund this amount through GMO-PG? を確認してください。全額返金と一部返金に対応しており、金額は整数の円です。上限は、注文合計ではなく、GMO-PG が実際に徴収して保持している金額です。残りの全額を返金すると GMO-PG の取引は取り消され、取り消し（void）になるか返品になるかは GMO-PG が判断します。一部返金では、取引の金額が減ります。返金は決済が行われた環境に送信されるため、その環境の Shop ID と Shop password が設定されている必要があります。GMO-PG が返金を受け付けない場合、タブにエラーが表示され、返金は記録されません。返金に成功すると、返金履歴とメモに追加されます。全額返金の場合、購入者への通知や商品の在庫への戻しは行わずに、注文のステータスが Refunded Status になります。これは、手動によるステータス変更と同じです。一部返金ではステータスは変わりません。
Sales > Returns での商品返品では、GMO-PG を通じて返金は行われません。
GMO-PG のコンソールで行われた返金やキャンセルは、結果通知によって反映され、メモに追加されます。GMO-PG で取り消された承認または保留中の決済を除き、注文ステータスは自動的には変更されません。必要に応じて手動で更新してください。
ライセンスキー
この拡張機能は、vibefox.net で取得した VibeFox ライセンスキーで動作します。ライセンスブロック License — VibeFox GMO Payment Gateway は、Extensions > Extensions > Payments > VibeFox GMO Payment Gateway > Edit の最初のブロックで、設定の上にあります。キーを License key に貼り付け、Activate をクリックします。その後、ブロックにはマスクされたキー、ステータス（たとえばライセンスの有効期限日と貴店のドメイン）、そして次のボタンが表示されます。ステータスを再確認する Check now、別のキーを入力する Change key、このストアからキーを削除する Remove key。その下には、Product: opencart-payment-gmo の行と、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 のアカウントで枠を解放してください。
有効なキーがない場合、GMO-PG のクレジットカード決済は、チェックアウトで購入者には表示されません。それでも決済が開始された場合、購入者には 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 ジョブは必要ありません。拡張機能をアンインストールすると、ライセンスキーとライセンスステータスは常に削除されます。
トラブルシューティング
Credit card does not appear at checkout: ライセンスが有効であること、Enable/Disable がオンであること、チェックアウトの通貨が JPY であること、現在の環境に Shop ID、Shop password、Config ID があることを確認してください。9,999,999 JPY を超える合計金額はカードで決済できません。通貨または認証情報が誤っている場合、設定ページに警告が表示されます。また、支払い住所が選択された Geo Zone に含まれていること、注文が設定の Total に達していることも確認してください。
The payment went through, but the order stays without a status: 結果通知が機能していません。使用している環境の GMO-PG ショップコンソールで、結果通知が有効になっていること、URL が Notification URL に表示されたものと完全に一致していることを確認してください。その環境の Shop ID と Shop password が入力されていることも確認してください。拡張機能は、それらを使って各通知を検証します。Debug log をオンにし、拡張機能のページの Log フィールドを確認してください。購入者が決済後にストアに戻った場合も、注文はステータスを受け取ります。
Log shows Notification rejected: unknown ShopID.: 通知が、Shop ID が設定に含まれていないショップから届いています。その環境の Shop ID を入力してください。
Log shows Notification ignored: OrderID is not a payment of this store.: 取引は、このストアが作成したものではありません（たとえば GMO-PG のコンソールで行われた場合）。対応は不要です。
Log shows that the order was paid in another environment: テスト決済と本番決済は分けて扱われます。テスト通知が本番決済を確認することはなく、その逆もありません。
The customer sees an error after Confirm Order: Debug log をオンにして、Log フィールドを確認してください。ログには GMO-PG のエラーコード（ErrCode、ErrInfo）が表示されます。Shop ID、Shop password、Config ID の誤りが一般的な原因です。This payment method is not available at the moment. Please choose another payment method. は、チェックアウトのセッションが注文と一致しなくなったか、その間に決済方法がオフにされたことを意味します。購入者はチェックアウトを再読み込みする必要があります。
Order is in the GMO-PG payment on hold status: VibeFox GMO Payment Gateway タブのメモを確認してください。注文は承認のみで、キャプチャを待っているか、支払われた金額が注文と異なっています。
Refund or capture fails: タブのメッセージを確認してください。注文が、Shop ID とパスワードが設定されていない別の環境で支払われた可能性があります。取引が GMO-PG で取り消されている可能性もあります。または、金額が取引の残額を超えている可能性もあります。The order is being updated by GMO-PG right now. Try again in a moment. は、同時に通知が処理されていたことを意味します。
The tab shows You do not have permission to refund orders.: ユーザーグループにこの拡張機能を変更する権限がありません。管理者に System > Users > User Groups で権限を付与してもらってください。
アンインストール
Extensions > Extensions に移動し、種類 Payments を選択して、VibeFox GMO Payment Gateway の横にある Uninstall（赤い − ボタン）をクリックします。この拡張機能のライセンスキーとライセンスステータスは常に削除されます。OpenCart は、拡張機能自身の設定を常に削除します：Enable/Disable、Sort Order、Geo Zone、Total、および Order statuses セクションのフィールドです。これらは再インストール時に初期値に戻ります。OpenCart 4 では、拡張機能のイベント（チェックアウトのメッセージ）と、メンテナンスモードでも通知と戻りを通過させる起動時アクションも削除されます。Delete data on uninstall がオンの場合、その他のゲートウェイ設定（タイトル、説明、環境、認証情報、キャプチャ、支払い後の注文ステータス、デバッグログのスイッチ）とログも削除されます。オフの場合は、後で再インストールするために保持されます。GMO-PG の取引と返金は常に保持されるため、以前に支払われた注文も、再インストール後にキャプチャと返金ができます。既存の注文は、決済のメモを保持します。
OpenCart 4 で拡張機能のファイルも削除するには、アンインストール後に Extensions > Installer に移動し、インストール済み拡張機能の一覧で VibeFox GMO Payment Gateway の横にある Uninstall（オレンジ色の − ボタン）をクリックしてから、Delete（赤いゴミ箱のボタン）をクリックして、アップロードされたパッケージを削除します。
GMO Payment Gateway は、各所有者の商標です。この拡張機能は、GMO Payment Gateway との提携や承認を受けたものではありません。