Skip to main content

【EC-CUBE】Getting and Configuring Your API Keys (Live / Test)

Updated

Get your API keys from the KOMOJU Dashboard's "Your ID and API Keys" page, then enter and save them under EC-CUBE's "KOMOJU Payment → Settings" page.

Your Live Mode and Test Mode API keys are different values. Each time you switch modes in the KOMOJU Dashboard, you must re-enter the matching values in EC-CUBE.
There is no visual indicator on the checkout page showing you're in Test Mode, so be careful not to forget to switch back before going live.

Getting and Entering Your API Keys

  1. Log in to the KOMOJU Dashboard
  2. Navigate to Settings
  3. Copy the Merchant ID, Secret Key, and Publishable Key
  4. In your EC-CUBE admin panel, navigate to KOMOJU Payment → Settings
  5. Enter the three copied values in the API Credentials card
  6. Click Save at the bottom of the page

Differences Between Live Mode and Test Mode Values

The Merchant ID, Secret Key, and Publishable Key values differ depending on the mode selected in the KOMOJU Dashboard.

  • Live Mode: production values used for real payments
  • Test Mode: values used to verify your integration. Switch the KOMOJU Dashboard to Test Mode to retrieve these values

In both cases, enter the values using the same steps into the API Credentials card under KOMOJU Payment → Settings in EC-CUBE.

When Switching to Live Mode

After updating your API keys to the Live Mode values, be sure to click Refresh payment methods to sync your live payment methods. If you skip this step, some payment methods may not appear at checkout.

Also, webhooks must be registered separately for Live Mode and Test Mode. A webhook registered in Test Mode does not carry over to Live Mode, so when you switch to Live Mode, be sure to register a separate webhook for it as well. See "Configuring Webhooks" for setup instructions.

Checklist for Switching to Live Mode

  • Switched to Live Mode in the KOMOJU Dashboard
  • Copied the Live Mode Merchant ID, Secret Key, and Publishable Key
  • Entered and saved these values in the API Credentials card under KOMOJU Payment → Settings in EC-CUBE
  • Clicked Refresh payment methods to sync live payment methods
  • Confirmed that webhooks are registered for the Live Mode environment
  • Registered a separate webhook for Live Mode (a separate registration from Test Mode is required)

Related Articles