メインコンテンツへスキップ

【EC-CUBE】EC-CUBEをはじめる（導入ガイド）

更新

【EC-CUBE】EC-CUBEをはじめる（導入ガイド）

EC-CUBE（4.2/4.3系）へのKOMOJU決済導入は、オーナーズストアからのプラグイン入手→APIキー設定→決済方法の同期、という流れが基本です。

対応バージョンはEC-CUBE 4.2/4.3系です。導入には、KOMOJUアカウントのLiveモード（本番環境）が利用可能な状態であることが前提となります。
Liveモードの利用申請が未承認（審査中・未申請）の場合は、先に申請を完了してください。

前提条件

  • KOMOJUアカウント（未取得の場合はこちらから登録）
  • KOMOJUアカウントのLiveモード（本番環境）が利用可能な状態であること
  • EC-CUBEストアの管理者権限
  • EC-CUBE管理画面の基本操作に慣れていること

対応バージョン

KOMOJU決済プラグインは、EC-CUBE 4.2/4.3系に対応しています。

プラグインの入手方法（オーナーズストア）

KOMOJU決済プラグインは、EC-CUBEの「オーナーズストア」から入手します。一般的なEC-CUBEのオーナーズストア経由プラグインの導入と同じ流れで進めます。

  1. EC-CUBEオーナーズストアへ会員登録します（未登録の場合のみ・1回のみ）
  2. オーナーズストアのMYページ内で、インストール先のサイトURLを登録し、認証キーを取得します（1回のみ）
  3. 取得した認証キーをEC-CUBE管理画面に登録します（1回のみ）
  4. オーナーズストアの「プラグインを探す」から「KOMOJU決済プラグイン」を選択し、導入手続きを行います
  5. EC-CUBE管理画面の「プラグイン一覧」画面に反映された「KOMOJU決済プラグイン」の「インストール」をクリックしてインストールします
  6. 「プラグイン一覧」の「オーナーズストアのプラグイン」に表示されたインストール済プラグインの「▶」（有効化）をクリックします
  7. 有効化すると、左サイドメニューに「KOMOJU決済」が表示されます

インストール・有効化の詳細な画面操作は、次の記事で解説します。

導入の流れ（全体像）

本番公開までの大まかな流れは、次のとおりです。

  1. KOMOJUアカウントの準備・Liveモード利用申請の確認
  2. KOMOJU決済プラグインの入手・インストール・有効化（オーナーズストア）
  3. APIキー（クライアントID／非公開鍵／公開鍵）の設定
  4. 決済方法の同期、および決済方法と配送方法の紐付け
  5. Webhookの設定
  6. 売上確定モードの設定（即時売上確定／オーソリのみ）
  7. TESTモードでのテスト決済による動作確認
  8. Liveモード（本番環境）への切り替え・本番公開

KOMOJU決済プラグインの連携の仕組み

KOMOJU決済プラグインは、対応するすべての決済方法を1つにまとめて管理します。インストールしてAPIキーを登録すれば、あとは管理画面から決済方法を同期するだけで導入が完了します。

決済の流れは次のとおりです。

  1. 顧客がチェックアウト画面に進みます
  2. 有効な決済方法が選択肢に表示されます
  3. 決済方法を選ぶと、KOMOJUのホスト型決済ページへ遷移します
  4. KOMOJUが決済処理を行い、Webhookで通知を送ります
  5. EC-CUBE側の注文ステータスが自動更新されます

決済データの取り扱いについて

カード番号などの機密データは、EC-CUBEのサーバーを通りません。決済処理はすべて、PCI DSSに準拠したKOMOJU側の決済ページで完結します。

各詳細ガイド

導入・設定の詳細な手順は、以下のセットアップガイドをご参照ください。

導入後の運用でよくある確認事項・トラブル対応は、以下の運用ガイドをご参照ください。

関連記事