Skip to main content

EC-CUBE Plugin

Accept payments on your EC-CUBE store with Omise. Specialized support for Japanese market including Konbini, Pay-easy, and JCB cards.

Overview​

  • EC-CUBE 4.x support
  • Composer installation
  • Japanese payment methods
  • JCB card support
  • Konbini payments
  • Pay-easy support
  • Multi-language (Japanese/English)

Prerequisites​

Requirements:

  • EC-CUBE 4.0.x or higher
  • PHP 7.4 or higher
  • Composer installed
  • Active Omise Japan account
  • Admin access

Installation​

Via Composer​

# Navigate to EC-CUBE root
cd /path/to/eccube

# Require Omise plugin
composer require omise/omise-eccube

# Install plugin
php bin/console eccube:plugin:install --code=Omise

# Enable plugin
php bin/console eccube:plugin:enable --code=Omise

# Clear cache
php bin/console cache:clear

Manual Installation​

  1. Download from GitHub
  2. Extract to app/Plugin/Omise
  3. Run installation commands above

Configuration​

Plugin Settings​

管理画面 → オーナーズストア → プラグイン → Omise設定

基本設定:
- 有効化: はい
- テストモード: はい (テスト時)
- 本番モード: いいえ (本番時)

APIキー:
- 公開鍵 (テスト): pkey_test_xxxxx
- 秘密鍵 (テスト): skey_test_xxxxx

Payment Methods​

Credit Cards (クレジットカード):

✓ Visa
✓ Mastercard
✓ American Express
✓ JCB (日本発行)
✓ Diners Club
✓ 3Dセキュア対応

Konbini (コンビニ決済):

✓ セブンイレブン
✓ ファミリーマート
✓ ローソン
✓ ミニストップ
✓ セイコーマート

支払い期限: 3日間
手数料: 注文金額により変動

Pay-easy (ペイジー):

✓ ATM支払い
✓ ネットバンキング
✓ 収納機関番号発行
✓ お客様番号発行

支払い期限: 7日間

Internet Banking (ネットバンキング):

対応銀行:
- Bangkok Bank
- Kasikorn Bank
- SCB
- その他主要銀行

Webhook Configuration​

Webhook URL:
https://yourstore.com/shopping/omise_webhook

Omiseダッシュボード設定:
設定 → Webhook → Webhook追加
- URL: 上記のWebhook URL
- イベント: charge.complete, charge.failed

Testing​

Test Cards​

成功するテスト:
カード番号: 4242 4242 4242 4242
有効期限: 12/28
セキュリティコード: 123

失敗するテスト:
カード番号: 4000 0000 0000 0002

3Dセキュア登録失敗:
カード番号: 4111 1111 1115 0002 (Visa)

3Dセキュア認証失敗:
カード番号: 4111 1111 1114 0003 (Visa)

Test Konbini Payment​

1. コンビニ決済を選択
2. コンビニを選択
3. テスト支払い番号が発行される
4. テストモードで確認

Order Management​

注文状態の管理​

注文状態マッピング:
- 新規注文 → 決済待ち
- 決済完了 → 決済完了
- 決済失敗 → キャンセル
- 返金 → 返金済み

返金処理​

返金方法:
1. 受注管理 → 注文詳細
2. 返金ボタンをクリック
3. 返金額を入力
4. 返金理由を入力
5. 実行

返金制限:
- クレジットカード: 120日以内
- コンビニ: 返金不可
- Pay-easy: 返金不可

Japanese Payment Methods​

Konbini Payments​

Customer Flow:

1. チェックアウトでコンビニ決済選択
2. コンビニ選択 (セブン、ファミマなど)
3. 支払い番号発行
4. コンビニ店舗で支払い
5. 支払い確認後、注文処理

Merchant Requirements:

✓ 日本の事業者登録
✓ Konbini支払い有効化
✓ 支払い期限設定
✓ メール通知設定

Pay-easy Payments​

Setup:

設定:
✓ Pay-easy有効化
✓ 支払い期限: 7日間
✓ 収納機関番号取得
✓ 確認メール設定

Customer Instructions:

お支払い方法:
1. ATMまたはネットバンキング
2. 「Pay-easy」を選択
3. 収納機関番号入力
4. お客様番号入力
5. 確認番号入力
6. 支払い完了

Customization​

Japanese Language​

src/Eccube/Resource/locale/ja/messages.ja.yaml

omise:
  payment:
    credit_card: 'クレジットカード'
    konbini: 'コンビニ決済'
    paydasy: 'Pay-easy'
    button: 'お支払いへ進む'

Custom Templates​

app/Plugin/Omise/Resource/template/default/Shopping/payment.twig

カスタマイズ:
- 決済方法の表示
- アイコンの変更
- レイアウト調整
- ボタンテキスト

Email Templates​

メールテンプレート編集:
コンテンツ管理 → メールテンプレート

カスタマイズ:
- 注文確認メール
- 支払い完了メール
- Konbini支払い番号通知
- Pay-easy支払い情報

Troubleshooting​

よくある問題​

プラグインがインストールできない:

解決方法:
1. Composerバージョン確認
2. PHP要件確認
3. ファイル権限確認
4. var/cache削除
5. 再インストール試行

決済が完了しない:

確認事項:
1. APIキー正しいか
2. テスト/本番モード一致
3. Webhookが動作中
4. ログファイル確認
5. ネットワーク接続確認

Konbini支払いが表示されない:

確認:
1. Omiseアカウントで有効化済み
2. 日本円 (JPY) 設定
3. プラグイン設定確認
4. キャッシュクリア

Debug Mode​

デバッグモード有効化:
.env ファイル:
APP_DEBUG=true
APP_ENV=dev

ログ確認:
var/log/dev/

Security​

セキュリティ対策​

✓ HTTPS必須
✓ 3Dセキュア有効化
✓ 定期的なアップデート
✓ 強力なパスワード
✓ 二要素認証
✓ IPアクセス制限
✓ 定期的なバックアップ

Frequently Asked Questions​

Q: EC-CUBE 3.xに対応していますか?
A: いいえ、EC-CUBE 4.x以上が必要です。3.x用は別バージョンをご利用ください。

Q: Konbini決済の手数料は?
A: 注文金額により変動します。詳細はOmiseサポートにお問い合わせください。

Q: JCBカードは使えますか?
A: はい、日本発行のJCBカードに対応しています。

Q: 返金はどのくらいかかりますか?
A: クレジットカードは7-14営業日です。Konbini/Pay-easyは返金不可です。

Q: 多言語対応していますか?
A: 日本語と英語に対応しています。

Q: モバイル対応していますか?
A: はい、スマートフォンでも快適に利用できます。

Q: 定期課金に対応していますか?
A: プラグイン単体では非対応です。Omise Subscription APIの別途実装が必要です。

Q: テスト環境はありますか?
A: はい、テストモードで安全にテストできます。

Next Steps​

Resources​

お問い合わせ: support@omise.co