CartModules: KOMOJU Payment Gateway

Accept Japanese & International Payments in Your CS-Cart Store

Integrate KOMOJU — Japan's leading multi-gateway payment aggregator — directly into your CS-Cart or Multi-Vendor store. Offer your customers their preferred payment methods including credit cards, Konbini (convenience store), Bank Transfer, PayEasy, LINE Pay, Merpay, PayPay, au PAY, and more through a single integration.

Key Features

• Dual Checkout Modes — Choose between redirect (hosted page) or inline (embedded Komoju.js) checkout
• On-Site Payment — Inline mode keeps customers on your store during payment
• Multi-Payment Gateway — One integration, dozens of payment methods popular in Japan and internationally
• Hosted Checkout — Customers pay on KOMOJU's secure page (PCI SAQ A compliant)
• Automatic Order Updates — Session status queried and verified on customer return
• Webhook Support — Server-to-server notifications with HMAC-SHA256 signature verification for asynchronous payment methods
• Test/Live Key Toggle — Switch between test and production keys from the admin panel
• Configurable Order Statuses — Map KOMOJU statuses (completed, cancelled, failed) to any CS-Cart order status
• JPY Native Support — Handles zero-decimal currency (JPY) correctly with integer amounts
• Idempotent Callbacks — Duplicate callbacks and webhooks are safely ignored
• Secure API Communication — HTTP Basic Auth with TLS, sensitive data stripped from logs

Supported Payment Methods

• Credit Cards (Visa, Mastercard, JCB, AMEX, Diners Club)
• Konbini (7-Eleven, Lawson, FamilyMart, Ministop, etc.)
• Bank Transfer (Japan)
• PayEasy (ATM/Online Banking)
• LINE Pay
• Merpay
• PayPay
• au PAY
• And more as KOMOJU adds new methods

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• KOMOJU merchant account with API credentials
• Store currency set to JPY (also supports USD, EUR, and others)

How It Works

1. Customer selects KOMOJU at checkout and clicks "Place Order"
2. The addon creates a checkout session via the KOMOJU Sessions API
3. Customer is redirected to the KOMOJU hosted checkout page
4. Customer selects their preferred payment method and completes payment
5. Customer is redirected back to your store
6. The addon queries the session status and updates the order accordingly
7. For asynchronous methods (Konbini, etc.), webhooks update the order when payment is confirmed

Checkout Modes

• Redirect (Default) — Customer is redirected to KOMOJU's secure hosted checkout page
• Inline (Embedded) — Komoju.js SDK renders an embedded payment form directly on your checkout page

Installation

1. Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
2. Activate the addon and enter the license key
3. Go to Administration > Payment methods and create a new payment method
4. Select "KOMOJU Payment Gateway" as the processor
5. Enter your Secret Key from the KOMOJU dashboard
6. Optionally enter the Webhook Secret Key for webhook signature verification
7. Configure order status mappings as desired
8. Save and test with a test secret key before going live

Country & Currency

This addon is designed primarily for merchants selling in Japan. KOMOJU's primary currency is JPY (Japanese Yen), but it also supports international currencies including USD, EUR, and others. JPY amounts are handled as integers (no decimal places).