APIキーは、KOMOJU管理画面「ID / API キー」で取得し、EC-CUBE管理画面「KOMOJU決済 → 設定」の「APIキー設定」カードに入力・保存します。
APIキーの取得と設定
- KOMOJU管理画面にログインします
- 「設定」を開きます
- 「クライアントID」「非公開鍵（Secret Key）」「公開鍵（Publishable Key）」の3つの値をコピーします
- EC-CUBE管理画面で「KOMOJU決済 → 設定」を開きます
- 「APIキー設定」カードに、コピーした3つの値を入力します
- ページ下部の「保存」をクリックします
Live／Testモードの値の違い
クライアントID・非公開鍵・公開鍵の値は、KOMOJU管理画面のモードごとに異なります。
- Liveモード（本番環境）：実際の決済に使用する本番用の値
- Testモード：動作確認に使用するテスト用の値。KOMOJU管理画面をTestモードに切り替えて取得します
どちらのモードでも、取得した値は上記と同じ手順でEC-CUBE「KOMOJU決済 → 設定」の「APIキー設定」カードに入力・保存します。
本番切替時の注意点
APIキーをLiveモード用の値に更新したあとは、必ず「決済方法を更新」をクリックし、本番用の決済方法を同期してください。同期を忘れると、チェックアウト画面に決済方法が表示されない場合があります。
また、WebhookはLiveモード・Testモードでそれぞれ個別に登録が必要です。Testモードで登録したWebhookはLiveモードには反映されないため、本番切替時はLiveモード用のWebhookも別途登録してください。設定方法は「Webhookの設定方法」をご確認ください。
本番切替時のチェックリスト
- KOMOJU管理画面でLiveモードに切り替えたか
- Liveモード用のクライアントID・非公開鍵・公開鍵をコピーしたか
- EC-CUBE「KOMOJU決済 → 設定」の「APIキー設定」カードに貼り付け、保存したか
- 「決済方法を更新」をクリックし、本番用の決済方法を同期したか
- Liveモード環境でもWebhookが登録済みであることを確認したか
- Liveモード用のWebhookを個別に登録したか（Testモードとは別登録が必要）