---
title: "Getting Started with WooCommerce"
description: "Install the KOMOJU Payments plugin, connect your account, enable payment methods, and run test payments before going live."
url: "https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/ec-integrations/woocommerce/getting-started-with-woocommerce"
source_url: "https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/ec-integrations/woocommerce/getting-started-with-woocommerce.md"
language: en
last_modified: "2026-06-01"
---

## Overview

This guide walks you through installing the KOMOJU Payments plugin, connecting it to your KOMOJU account, enabling payment methods at checkout, and running a test payment before going live.

> ⚠️ **Warning:** This guide assumes your Live Mode application is already approved. If your application is still pending or you haven't applied yet, complete that process first before following this guide. See [How to Apply for Live Mode (Commercial Use)](https://help.komoju.com/hc/en-us/articles/4747529679006-How-to-Apply-for-Live-Mode-Commercial-Use).

## Understanding the WooCommerce-KOMOJU Integration

KOMOJU for WooCommerce uses a single plugin that handles all payment methods. Unlike some integrations that require a separate app per payment method, you install KOMOJU Payments once and then choose which payment methods to enable from within the plugin settings.

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

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

> ℹ️ **Note:** KOMOJU supports local payment methods across Japan, South Korea, China, Southeast Asia, and Europe — including convenience store payments (konbini), PayPay, Alipay, GrabPay, and credit/debit cards. Each method you enable appears as a separate option at checkout.

## Installing the Plugin

### Step 1: Search for KOMOJU Payments in WordPress

1. Log in to your WordPress admin dashboard
2. Navigate to **Plugins → Add Plugin**
3. In the search field, type **KOMOJU**
4. Locate **KOMOJU Payments** in the results and click **Install Now**

![woocommerce_getting-started_1.png](https://docs.priv.staging.komoju-dev.tools/woocommerce_getting-started_1.png)

### Step 2: Activate the Plugin

Once installation completes, the button changes to **Activate** — click it.

To confirm the plugin installed correctly, go to **Plugins** and check that **KOMOJU Payments** appears in the list with a **Deactivate** link visible.

## Connecting Your KOMOJU Account

Rather than manually entering API keys, KOMOJU uses an OAuth-style sign-in flow that automatically configures your secret key and webhooks.

### Step 1: Open the KOMOJU Settings Tab

From your WordPress admin, navigate to **WooCommerce → Settings → KOMOJU**.

![woocommerce_getting-started_2.png](https://docs.priv.staging.komoju-dev.tools/woocommerce_getting-started_2.png)

### Step 2: Sign In to KOMOJU

Click **Sign into KOMOJU**. You'll be redirected to the KOMOJU login page.

![woocommerce_getting-started_3.png](https://docs.priv.staging.komoju-dev.tools/woocommerce_getting-started_3.png)

### Step 3: Select Your Account and Mode

After logging in, you'll see your KOMOJU account(s) listed. Select the account you want to connect and choose a mode:

- **Test Mode** — for testing payments without processing real transactions
- **Live Mode** — for accepting real customer payments (requires prior approval)

> ℹ️ **Note:** Live Mode will only be selectable if your KOMOJU account has been approved. If it appears greyed out, your application is still under review.

![woocommerce_getting-started_4.png](https://docs.priv.staging.komoju-dev.tools/woocommerce_getting-started_4.png)

### Step 4: Confirm the Connection

You'll be redirected back to WooCommerce. If the connection was successful, your available payment methods will appear in the KOMOJU settings tab.

## Enabling Payment Methods

Seeing payment methods in the KOMOJU tab is not enough — you also need to activate them in WooCommerce's payments settings so they appear at checkout.

### Step 1: Select Payment Methods in the KOMOJU Tab

In **WooCommerce → Settings → KOMOJU**, check the box next to each payment method you want to offer, then click **Save Changes**.

![woocommerce_getting-started_5.png](https://docs.priv.staging.komoju-dev.tools/woocommerce_getting-started_5.png)

### Step 2: Enable Them in WooCommerce Payments

Navigate to **WooCommerce → Settings → Payments**. You'll see each selected payment method listed as **KOMOJU – [Payment Method Name]**.

Toggle each method **On** and click **Save Changes** at the bottom of the page.

![woocommerce_getting-started_6.png](https://docs.priv.staging.komoju-dev.tools/woocommerce_getting-started_6.png)

> ℹ️ **Note:** The KOMOJU tab controls which payment methods are available to configure. The Payments tab controls which ones are actually shown to customers at checkout. Both steps are required.
>
> Also please note that the Payments page may look different based on the version of WooCommerce you are using. For newer versions, the toggles have been replaced with buttons.

> ⚠️ **Warning:** Please be sure to enable each payment method individually. There is a legacy **Komoju** payment method that has been deprecated, and should no longer be used.

## Testing Your Integration

Before going live, run a test payment to verify the full flow works correctly.

### Step 1: Connect in Test Mode

If you selected **Test Mode** when connecting your account (Step 3 above), your store is already in test mode. If you connected in Live Mode and want to test, return to **WooCommerce → Settings → KOMOJU** and sign in again selecting Test Mode.

### Step 2: Place a Test Order

Open your store's checkout as a customer would and complete a payment using one of your enabled methods. KOMOJU has dummy pages available for most payment methods to simulate making a payment.

For testing credit cards, please review the following page for sample test card numbers[Test Inputs](https://doc.komoju.com/docs/test-cards)

### Step 3: Verify in Both Dashboards

After completing the test payment, confirm it appears in:

- **WooCommerce → Orders** — the order should show with an updated status
- **KOMOJU Dashboard → Payments** — the payment should be listed with a completed or authorized status

> ⚠️ **Warning:** Make sure you switch back to Live Mode before your store goes live. There is no visual indicator on the checkout page telling customers they are in test mode.

## Going Live

When you're ready to accept real payments:

1. Go to **WooCommerce → Settings → KOMOJU**
2. Click **Reconnect with KOMOJU**
3. Select your account and choose **Live Mode**
4. Save and confirm the connection

No additional approval steps are needed at this point — as long as your Live Mode application was already approved, you're ready to go.