EC-CUBE プラグイン
Omiseを使用してEC-CUBEストアで支払いを受け付けます。コンビニ、ペイジー、JCBカードを含む日本市場向けの専門的なサポート。
概要
- EC-CUBE 4.x サポート
- Composer インストール
- 日本の決済方法
- JCB カード サポート
- コンビニ 支払い
- ペイジー サポート
- 複数言語（日本語/英語）
前提条件
要件:
- EC-CUBE 4.0.x 以上
- PHP 7.4 以上
- Composer がインストール済み
- アクティブな Omise Japan アカウント
- 管理者アクセス
インストール
Composer 経由
# EC-CUBE ルート に移動
cd /path/to/eccube
# Omise プラグインを要求
composer require omise/omise-eccube
# プラグインをインストール
php bin/console eccube:plugin:install --code=Omise
# プラグインを有効化
php bin/console eccube:plugin:enable --code=Omise
# キャッシュをクリア
php bin/console cache:clear
手動インストール
- GitHub からダウンロード
app/Plugin/Omiseに抽出- 上記のインストール コマンドを実行
設定
プラグイン設定
管理画面 → オーナーズストア → プラグイン → Omise設定
基本設定:
- 有効化: はい
- テストモード: はい（テスト時）
- 本番モード: いいえ（本番時）
APIキー:
- 公開鍵（テスト）: pkey_test_xxxxx
- 秘密鍵（テスト）: skey_test_xxxxx
決済方法
クレジット カード（クレジットカード）:
✓ Visa
✓ Mastercard
✓ American Express
✓ JCB（日本発行）
✓ Diners Club
✓ 3D セキュア対応
コンビニ（コンビニ決済）:
✓ セブン イレブン
✓ ファミリー マート
✓ ローソン
✓ ミニ ストップ
✓ セイコー マート
支払い 期限: 3 日間
手数料: 注文金額により変 動
ペイジー（ペイジー）:
✓ ATM 支払い
✓ ネット バンキング
✓ 収納 機関 番号 発行
✓ お客様 番号 発行
支払い 期限: 7 日間
インターネット バンキング（ネットバンキング）:
対応 銀行:
- Bangkok Bank
- Kasikorn Bank
- SCB
- その他 主要 銀行
Webhook 設定
Webhook URL:
https://yourstore.com/shopping/omise_webhook
Omise ダッシュボード 設定:
設定 → Webhook → Webhook 追加
- URL: 上記の Webhook URL
- イベント: charge.complete、charge.failed
テスト
テスト カード
成功するテスト:
カード 番号: 4242 4242 4242 4242
有効 期限: 12/28
セキュリティ コード: 123
失敗するテスト:
カード 番号: 4000 0000 0000 0002
3D Secure 登録 失敗:
カード 番号: 4111 1111 1115 0002 (Visa)
3D Secure 認証 失敗:
カード 番号: 4111 1111 1114 0003 (Visa)
コンビニ 支 払いをテスト
1. コンビニ 決済を選択
2. コンビニを選択
3. テスト 支払い 番号が発行される
4. テスト モードで確認
注文管理
注文状態の管理
注文状態マッピング:
- 新規 注文 → 決済待ち
- 決済 完了 → 決済完了
- 決済 失敗 → キャンセル
- 返金 → 返金済み
返金処理
返金方法:
1. 受注 管理 → 注文 詳細
2. 返金 ボタンをクリック
3. 返金額を入力
4. 返金理由を入力
5. 実行
返金制限:
- クレジット カード: 120 日以内
- コンビニ: 返金不可
- ペイジー: 返金不可
日本の決済方法
コンビニ 支払い
顧客フロー:
1. チェックアウトで コンビニ 決済を選択
2. コンビニを選択（セブン、ファミマなど）
3. 支払い 番号が発行される
4. コンビニ 店舗で支払い
5. 支払い確認後、注文処理
マーチャント 要件:
✓ 日本の事業者登録
✓ コンビニ 支払いを有効化
✓ 支払い期限を設定
✓ メール通知を設定
ペイジー 支払い
セットアップ:
設定:
✓ ペイジーを有効化
✓ 支払い期限: 7 日間
✓ 収納 機関番号を取得
✓ 確認メール 設定
顧客 指示:
お支払い方法:
1. ATM または ネット バンキング
2. 「ペイジー」を選択
3. 収納 機関番号を入力
4. お客様 番号を入力
5. 確認 番号を入力
6. 支払い完了
カスタマイズ
日本語
src/Eccube/Resource/locale/ja/messages.ja.yaml
omise:
payment:
credit_card: 'クレジットカード'
konbini: 'コンビニ決済'
paydasy: 'ペイジー'
button: 'お支払いへ進む'
カスタム テンプレート
app/Plugin/Omise/Resource/template/default/Shopping/payment.twig
カスタマイズ:
- 決済方法の表示
- アイコンの変更
- レイアウト調整
- ボタン テキスト
メール テンプレート
メール テンプレート編集:
コンテンツ管理 → メール テンプレート
カスタマイズ:
- 注文 確認メール
- 支払い完了メール
- コンビニ支払い 番号通知
- ペイジー支払い 情報
トラブルシューティング
よくある問題
プラグイン インストール 失敗:
解決方法:
1. Composer バージョン確認
2. PHP 要件確認
3. ファイル権限確認
4. var/cache 削除
5. 再インストール 試行
決済が完了しない:
確認事項:
1. API キー 正しいか
2. テスト/本番 モード一致
3. Webhook が動作中
4. ログファイル 確認
5. ネットワーク 接続確認
コンビニ 支払いが表示されない:
確認:
1. Omise アカウント で有効化済み
2. 日本円（JPY）設定
3. プラグイン 設定確認
4. キャッシュ クリア
デバッグ モード
デバッグ モード 有効化:
.env ファイル:
APP_DEBUG=true
APP_ENV=dev
ログ確認:
var/log/dev/
セキュリティ
セキュリティ対策
✓ HTTPS 必須
✓ 3D セキュア 有効化
✓ 定期的な アップデート
✓ 強力な パスワード
✓ 二要素認証
✓ IP アクセス制限
✓ 定期的な バックアップ
よくある質問
Q: EC-CUBE 3.x に対応していますか? A: いいえ、EC-CUBE 4.x 以上が必要です。3.x 用は別バージョンをご利用ください。
Q: コンビニ決済の手数料は? A: 注文金額により変動します。詳細は Omise サポートにお問い合わせください。
Q: JCB カードは使えますか? A: はい、日本発行の JCB カードに対応しています。
Q: 返金はどのくらいかかりますか? A: クレジット カードは 7-14 営業日です。コンビニ/ペイジーは返金不可です。
Q: 多言語対応していますか? A: 日本語と英語に対応しています。
Q: モバイル対応していますか? A: はい、スマートフォンでも快適に利用できます。
Q: 定期課金に対応していますか? A: プラグイン単体では非対応です。Omise Subscription API の別途実装が必要です。
Q: テスト環境 はありますか? A: はい、テストモードで安全にテストできます。
次のステップ
- Wix 統合 - Wix 統合ガイド
- ダッシュボード ガイド - 支払いを管理
- 支払い方法 - 利用可能なメソッド
リソース
お問い合わせ: support@omise.co