OpenCart プラグイン
Omiseを使用してOpenCart ストアで支払いを受け付けます。OpenCart 3.x 向けの完全な決済ソリューションで、すべての Omise 決済方法に対応しています。
概要
- OpenCart 3.x サポート
- 簡単なファイル アップロード インストール
- すべての決済方法
- マルチストア サポート
- 自動注文更新
- モバイル フレンドリー チェックアウト
インストール
手動インストール
-
プラグインをダウンロード
- 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 圧縮を有効化
よくある質問
Q: サポート対象の OpenCart バージョンはどれですか? A: OpenCart 3.0.x が完全にサポートされています。OpenCart 2.x の場合、レガシー バージョンを使用してください。
Q: 本番運用前にテストできますか? A: はい、テスト モードを有効化してテスト API キーを使用して安全にテストできます。
Q: 本番モードに切り替えるにはどうしますか? A: テスト モードを無効化して、設定に本番 API キーを入力してください。
Q: 払い戻しは自動ですか? A: いいえ、Omise ダッシュボード経由で払い戻しを処理し、OpenCart 注文を手動で更新してください。
Q: 他の決済方法と一緒に使用できますか? A: はい、複数の決済方法を有効化できます。顧客はチェックアウト時に選択します。
Q: OpenCart 拡張機能と互換性がありますか? A: 一般的にはい。ただし、特 定の拡張機能での互換性をテストしてください。
Q: プラグインを更新するにはどうしますか? A: 最新バージョンをダウンロードし、ストアをバックアップしてから新しいファイルをアップロードしてキャッシュをクリアしてください。
Q: 顧客はカードを保存できますか? A: カード保存機能の利用可能性はプラグイン バージョンによって異なります。最新リリース ノートを確認してください。
Q: 複数通貨がサポートされていますか? A: はい、OpenCart で通貨を設定します。Omise でサポートされている通貨であることを確認してください。
Q: エラーが発生した場合はどうなりますか? A: エラー ログを確認し、設定を確認してからサンドボックスでテストし、必要に応じてサポートに連絡してください。
次のステップ
- EC-CUBE プラグイン - EC-CUBE 統合
- ダッシュボード ガイド - 支払いを管理
- 支払い方法 - 支払いオプション
リソース
お困りですか? support@omise.co に連絡してください