Skip to main content

【EC-CUBE】Getting Started with EC-CUBE (Setup Guide)

Updated

【EC-CUBE】Getting Started with EC-CUBE (Setup Guide)

Setting up KOMOJU on EC-CUBE (version 4.2/4.3) follows this order: get the plugin from the Owner's Store → enter your API credentials → sync payment methods.

The KOMOJU Payment plugin supports EC-CUBE 4.2/4.3. Before you begin, your KOMOJU account must have Live Mode activated.
If your Live Mode application is still pending or you haven't applied yet, complete that process first.

Prerequisites

  • A KOMOJU account (sign up here if you don't have one yet)
  • Live Mode activated on your KOMOJU account
  • Admin access to your EC-CUBE store
  • Basic familiarity with the EC-CUBE admin panel

Supported Version

The KOMOJU Payment plugin supports EC-CUBE 4.2/4.3.

Getting the Plugin (Owner's Store)

The KOMOJU Payment plugin is distributed through the EC-CUBE "Owner's Store." The steps follow the same flow as any other EC-CUBE plugin obtained through the Owner's Store.

  1. Register as an Owner's Store member (one-time step, if not already registered)
  2. From your Owner's Store account page, register your site URL and obtain an authentication key (one-time step)
  3. Register the authentication key in your EC-CUBE admin panel (one-time step)
  4. From "Find Plugins" in the Owner's Store, select the "KOMOJU Payment plugin" and proceed with the acquisition steps
  5. On the "Plugin List" screen in your EC-CUBE admin panel, click "Install" next to the KOMOJU Payment plugin that now appears there
  6. Click the "▶" (enable) icon next to the installed plugin under "Owner's Store Plugins" in the Plugin List
  7. Once enabled, "KOMOJU Payment" appears in the left sidebar navigation

Detailed screen-by-screen installation and activation steps are covered in the next article.

Setup Overview

Here is the overall flow to go live:

  1. Prepare your KOMOJU account and confirm your Live Mode application status
  2. Get, install, and enable the KOMOJU Payment plugin (via the Owner's Store)
  3. Enter your API credentials (Merchant ID, Secret Key, Publishable Key)
  4. Sync payment methods, and link payment methods to delivery methods
  5. Configure webhooks
  6. Set the capture mode (Authorize and Capture / Authorize Only)
  7. Run a test payment in Test Mode to verify the integration
  8. Switch to Live Mode and go live

How the KOMOJU Payment Plugin Works

The KOMOJU Payment plugin uses a single plugin that handles all payment methods. You install the plugin once, enter your API credentials, and then sync your available payment methods directly from the plugin settings page.

Here's how a payment works end-to-end:

  1. A customer reaches the checkout page on your EC-CUBE store
  2. The payment methods you've enabled appear as options
  3. The customer selects a method and is redirected to KOMOJU's hosted payment page to complete the transaction
  4. KOMOJU processes the payment and notifies EC-CUBE via webhook
  5. The EC-CUBE order status updates automatically

About Sensitive Payment Data

No sensitive payment data (credit card numbers, etc.) passes through your EC-CUBE server. All payment processing happens on KOMOJU's PCI-compliant hosted page.

Detailed Setup Guides

For detailed setup steps, see the following guides:

For common questions and troubleshooting after launch, see the following operational guides:

Related articles