【EC-CUBE】EC-CUBEをはじめる（導入ガイド）
EC-CUBE（4.2/4.3系）へのKOMOJU決済導入は、オーナーズストアからのプラグイン入手→APIキー設定→決済方法の同期、という流れが基本です。
前提条件
- KOMOJUアカウント（未取得の場合はこちらから登録）
- KOMOJUアカウントのLiveモード（本番環境）が利用可能な状態であること
- EC-CUBEストアの管理者権限
- EC-CUBE管理画面の基本操作に慣れていること
対応バージョン
KOMOJU決済プラグインは、EC-CUBE 4.2/4.3系に対応しています。
プラグインの入手方法（オーナーズストア）
KOMOJU決済プラグインは、EC-CUBEの「オーナーズストア」から入手します。一般的なEC-CUBEのオーナーズストア経由プラグインの導入と同じ流れで進めます。
- EC-CUBEオーナーズストアへ会員登録します（未登録の場合のみ・1回のみ）
- オーナーズストアのMYページ内で、インストール先のサイトURLを登録し、認証キーを取得します（1回のみ）
- 取得した認証キーをEC-CUBE管理画面に登録します（1回のみ）
- オーナーズストアの「プラグインを探す」から「KOMOJU決済プラグイン」を選択し、導入手続きを行います
- EC-CUBE管理画面の「プラグイン一覧」画面に反映された「KOMOJU決済プラグイン」の「インストール」をクリックしてインストールします
- 「プラグイン一覧」の「オーナーズストアのプラグイン」に表示されたインストール済プラグインの「▶」（有効化）をクリックします
- 有効化すると、左サイドメニューに「KOMOJU決済」が表示されます
インストール・有効化の詳細な画面操作は、次の記事で解説します。
導入の流れ（全体像）
本番公開までの大まかな流れは、次のとおりです。
- KOMOJUアカウントの準備・Liveモード利用申請の確認
- KOMOJU決済プラグインの入手・インストール・有効化（オーナーズストア）
- APIキー（クライアントID／非公開鍵／公開鍵）の設定
- 決済方法の同期、および決済方法と配送方法の紐付け
- Webhookの設定
- 売上確定モードの設定（即時売上確定／オーソリのみ）
- TESTモードでのテスト決済による動作確認
- Liveモード（本番環境）への切り替え・本番公開
KOMOJU決済プラグインの連携の仕組み
KOMOJU決済プラグインは、対応するすべての決済方法を1つにまとめて管理します。インストールしてAPIキーを登録すれば、あとは管理画面から決済方法を同期するだけで導入が完了します。
決済の流れは次のとおりです。
- 顧客がチェックアウト画面に進みます
- 有効な決済方法が選択肢に表示されます
- 決済方法を選ぶと、KOMOJUのホスト型決済ページへ遷移します
- KOMOJUが決済処理を行い、Webhookで通知を送ります
- EC-CUBE側の注文ステータスが自動更新されます
決済データの取り扱いについて
カード番号などの機密データは、EC-CUBEのサーバーを通りません。決済処理はすべて、PCI DSSに準拠したKOMOJU側の決済ページで完結します。
各詳細ガイド
導入・設定の詳細な手順は、以下のセットアップガイドをご参照ください。
導入後の運用でよくある確認事項・トラブル対応は、以下の運用ガイドをご参照ください。