OpenCart プラグイン
Omiseを使用してOpenCart ストアで支払いを受け付けます。OpenCart 3.x 向けの完全な決済ソリューションで、すべての Omise 決済方法に対応しています 。
概要
- OpenCart 2.0.3.1 サポート
- 簡単なファイル アップロード インストール
- すべての決済方法
- マルチストア サポート
- 自動注文更新
- モバイル フレンドリー チェックアウト
インストール
手動インストール
-
プラグインをダウンロード
- GitHub リリースにアクセス
- 最新バージョンの ZIP ファイルをダウンロード
-
ファイルをアップロード
- ZIP ファイルを抽出
upload/フォルダのコンテンツを OpenCart ルートにアップロード- 既存のディレクトリにマージ
- 拡張機能をインストール
- OpenCart 管理画面にログイン
- 拡張機能 → 拡張機能に移動
- 拡張機能タイプを選択: 支払い
- 「Omise Payment Gateway」を見つけ
- インストール ボタンをクリック（緑色の + ボタン）
設定
基本セットアップ
拡張機能 → 拡張機能 → 支払い → Omise Payment Gateway → 編集
一 般設定:
- ステータス: 有効化
- テスト モード: はい（テスト用）
API キー:
- 公開キー（テスト）: pkey_test_xxxxx
- 秘密キー（テスト）: skey_test_xxxxx
インストール後、青いペンシル ボタンをクリックして設定します：
設定ページでゲートウェイを有効化します：
設定フォームに API キーを入力します：
決済方法
メソッドを有効化:
クレジット/デビット カード:
✓ 有効化
✓ 3D Secure: はい
インターネット バンキング:
✓ 有効化
電子ウォレット:
✓ TrueMoney Wallet
✓ Rabbit LINE Pay
✓ ShopeePay
分割払い:
✓ 有効化
✓ 最小: 3,000 タイバーツ
Webhook セットアップ
Webhook URL フォーマット:
https://yourstore.com/index.php?route=extension/payment/omise/callback
Omise ダッシュボードに追加:
設定 → Webhooks → webhook を追加
- URL: （上記の webhook URL）
- イベント: charge.complete、charge.failed、refund.create
テスト
テスト環境
設定:
✓ テスト モード: 有効化
✓ テスト API キーが入力されている
✓ 変更キャッシュをクリア
テスト注文:
1. 商品をカートに追加
2. ゲストまたは登録済みでチェックアウト
3. Omise 決済を選択
4. テスト カードを使用: 4242 4242 4242 4242
5. 支払いを完了
6. 注文ステータスが更新されたことを確認
注文管理
支払い情報を表示
営業 → 注文 → 注文を表示
支払い情報に表示される内容:
- 使用された支払い方法
- Omise チャージ ID
- トランザクション金額
- 支払いステータス
- トランザクション日時
払い戻しを処理
Omise ダッシュボード経由の手動払い戻し:
- Omise ダッシュボードにログイン
- 請求を検索
- 「払い戻し」をクリック
- 金額を入力
- 払い戻しを確認
- OpenCart で注文を手動更新
注: OpenCart の払い戻しが Omise と自動的に同期されません。Omise ダッシュボード経由で払い戻しを処理してください。
マルチストア設定
複数のストア向け:
ストア 1:
- システム → 設定 → ストア 1 を編集
- ストアごとに異なる API キーを使用
- ストアごとに決済方法を設定
ストア 2:
- 設定を繰り返す
- 独立した設定
カスタマイズ
決済方法の順序
拡張機能 → 支払い
並び順フィールド:
- Omise: 1（最初に表示）
- その他のメソッド: 2、3、など
カスタム テンプレート
catalog/view/theme/[your-theme]/template/extension/payment/omise.twig
カスタマイズ:
- 決済方法の表示
- フォーム スタイリング
- ボタン テキスト
- 指示
言語 文字列
catalog/language/[language]/extension/payment/omise.php
$_['text_title'] = 'ชำระเงินผ่า น Omise';
$_['text_card'] = 'บัตรเครดิต/เดบิต';
$_['text_internet_banking'] = 'อินเทอร์เน็ตแบงก์กิ้ง';
トラブルシューティング
よくある問題
拡張機能が支払い方法に表示されない:
解決方法:
1. OpenCart キャッシュをクリア
2. ブラウザ キャッシュをクリア
3. 拡張機能が正しくインストールされていることを確認
4. ファイルが適切にアップロードされたことを確認
5. ファイル権限を確認
注文が更新されない:
解決方法:
1. webhook URL を確認
2. Omise ダッシュボード から webhook をテスト
3. OpenCart エラー ログを確認
4. PHP バージョンの互換性を確認
5. mod_security がブロックしていないことを確認
支払いリダイレクトが失敗:
解決方法:
1. SSL サーティフィケートが有効であることを確認
2. リターン URL が設定されていることを確認
3. 別の決済方法をテスト
4. OpenCart システム ログを確認
5. 競合する拡張機能を確認
デバッグ モード
OpenCart デバッグを有効化:
システム → 設定 → ストアを編集 → サーバー タブ
✓ エラーを表示
✓ エラーをログ
ログを確認:
system/storage/logs/error.log
セキュリティ
✓ HTTPS のみを使用
✓ OpenCart を最新に保つ
✓ 強力な管理者パスワードを使用
✓ 3D Secure を有効化
✓ 定期的にバックアップ
✓ 不審な注文を監視
✓ API キーを定期的にローテーション
ファイル権限
セキュアなファイル権限:
ファイル: 644
ディレクトリ: 755
config.php: 444
admin/config.php: 444
パフォーマンス
チェックアウトを最適化
✓ OpenCart キャッシングを有効化
✓ チェックアウト ステップを最小化
✓ 画像を最適化
✓ CDN を使用
✓ GZIP 圧縮を有効化
FAQ
サポート対象の OpenCart バージョンはどれですか?
OpenCart 3.0.x が完全にサポートされています。OpenCart 2.x の場合、レガシー バージョンを使用してください。
本番運用前にテストできますか?
はい、テスト モードを有効化してテスト API キーを使用して安全にテストできます。
本番モードに切り替えるにはどうしますか?
テスト モードを無効化して、設定に本番 API キーを入力してください。
払い戻しは自動ですか?
いいえ、Omise ダッシュボード経由で払い戻しを処理し、OpenCart 注文を手動で更新してください。
他の決済方法と一緒に使用できますか?
はい、複数の決済方法を有効化できます。顧客はチェックアウト時に選択します。
OpenCart 拡張機能と互換性がありますか?
一般的にはい。ただし、特定の拡張機能での互換性をテストしてください。
プラグインを更新するにはどうしますか?
最新バージョンをダウンロードし、ストアをバックアップしてから新しいファイルをアップロードしてキャッシュをクリアしてください。
顧客はカードを保存できますか?
カード保存機能の利用可能性はプラグイン バージョンによって異なります。最新リリース ノートを確認してください。
複数通貨がサポートされていますか?
はい、OpenCart で通貨を設定します。Omise でサポートされている通貨であることを確認してください。
エラーが発生した場合はどうなりますか?
エラー ログを確認し、設定を確認してからサンドボックスでテストし、必要に応じてサポートに連絡してください。
次のステップ
- EC-CUBE プラグイン - EC-CUBE 統合
- ダッシュボード ガイド - 支払いを管理
- 支払い方法 - 支払いオプション
リソース
お困りですか? support@omise.co に連絡してください