--- title: "エラーコード｜CheckoutOSドキュメント | Chargezen" description: "CheckoutOSのエラーコードと解決方法のリファレンス。Chargezen CheckoutOSドキュメント「トラブルシューティング」より。" url: "https://chargezen.com/ja/docs/checkoutos/troubleshooting/error-codes" lang: "ja" updated: "2025-01-16" --- Canonical URL: https://chargezen.com/ja/docs/checkoutos/troubleshooting/error-codes # エラーコード CheckoutOSのエラーコードと解決方法のリファレンス 最終更新日：2025-01-16 このリファレンスでは、CheckoutOSの利用中に発生する可能性のあるエラーコードを説明します。各エラーには、その意味と推奨する解決手順を記載しています。 エラーコードの確認場所 エラーコードはCheckoutOSダッシュボードの通知、ブラウザーコンソール、Webhookレスポンスに表示されます。`COS-XXXX`形式のコードを探してください。 ## インストールエラー（COS-1XXX） ### COS-1001：Shopify接続の失敗 **原因：** Shopifyストアへの接続を確立できません。 **解決方法：** * ShopifyストアのURLが正しいかを確認 * Shopifyストアが有効で、一時停止や保留中でないことを確認 * Shopify App StoreからCheckoutOSアプリを再インストール * Shopifyストアの管理者またはオーナー権限があることを確認 ### COS-1002：権限の拒否 **原因：** CheckoutOSに必要な権限がありません。 **解決方法：** * アプリを再インストールして権限を再承認 * ストアのオーナーまたは管理者としてログインしていることを確認 * Shopify Admin → Apps → CheckoutOSで権限の状態を確認 ### COS-1003：Checkout Extensibilityを利用できない **原因：** Shopifyプランがチェックアウト拡張機能に対応していません。 **解決方法：** * チェックアウトの拡張機能をすべて使うにはShopify Plusにアップグレード * Checkout Extensibilityのベータアクセスを申請（Plus以外のストア） * 購入後の機能のみを利用（すべてのプランで利用可能） ## キャンペーンエラー（COS-2XXX） ### COS-2001：無効なキャンペーン設定 **原因：** キャンペーンに不足または無効な設定があります。 **解決方法：** * キャンペーンの必須項目をすべて確認 * アップセル用の商品が少なくとも1つ選択されていることを確認 * 割引値が有効な範囲内かを確認 有効なキャンペーン構造 ```json { "name": "Summer Upsell", "active": true, "products": ["gid://shopify/Product/123"], "discount": { "type": "percentage", "value": 20 }, "targeting": { "minCartValue": 50 } } ``` ### COS-2002：商品が見つからない **原因：** キャンペーン内の商品が存在しないか、利用できません。 **解決方法：** * Shopifyカタログから商品が削除されていないかを確認 * 商品が公開され、有効であることを確認 * キャンペーンを有効な商品IDで更新 ### COS-2003：ターゲティングルールの競合 **原因：** キャンペーンのターゲティングルールが互いに矛盾しています。 **解決方法：** * ターゲティングルールのAND／ORの論理を確認 * 最小値と最大値が不適切に重複していないことを確認 * 不可能な条件がないかを確認（例：カート > US$100かつカート < US$50） ## チェックアウトエラー（COS-3XXX） ### COS-3001：割引適用の失敗 **原因：** アップセル商品に割引を適用できません。 **解決方法：** * 競合するShopify割引コードがないかを確認 * Shopifyで割引の組み合わせ設定を確認 * 商品が割引対象から除外されていないことを確認 ### COS-3002：支払い処理エラー **原因：** アップセル商品の代金を顧客に請求できません。 **解決方法：** * 通常はShopifyの決済ゲートウェイの問題 * Shopify Admin → Settings → Paymentsでゲートウェイの状態を確認 * 顧客は別の支払い方法で再試行する必要がある場合がある 支払いエラー CheckoutOSは支払い情報を保存しません。支払いエラーはShopifyの安全な決済インフラを通じて処理されます。詳細な支払いログはShopifyで確認してください。 ### COS-3003：在庫なし **原因：** アップセル商品が在庫切れです。 **解決方法：** * キャンペーン設定で在庫追跡の代替処理を有効にする * 在庫切れに備えて代替商品を設定 * 適切な場合はShopifyで"Continue selling when out of stock"を設定 ## APIエラー（COS-4XXX） ### COS-4001：無効なAPIキー **原因：** APIリクエストが無効または期限切れのキーを使用しました。 **解決方法：** * Dashboard → Settings → APIでAPIキーを再生成 * キーに入力ミスや空白がないかを確認 * キーに必要な権限があることを確認 ### COS-4002：レート制限の超過 **原因：** 短時間にAPIリクエストが多すぎます。 **解決方法：** * アプリケーションにリクエストの流量制御を実装 * ポーリングの代わりにWebhookイベントを使用 * より高いレート制限が必要な場合はサポートに連絡 レート制限ヘッダー ```text X-RateLimit-Limit: 100 X-RateLimit-Remaining: 0 X-RateLimit-Reset: 1642345678 Retry-After: 60 ``` ### COS-4003：無効なWebhook署名 **原因：** Webhook署名の検証に失敗しました。 **解決方法：** * WebhookシークレットがDashboard → Settings → APIと一致するかを確認 * 署名検証にリクエストの生の本文を使用していることを確認 * サーバーの時計が同期されていることを確認 ## 拡張機能エラー（COS-5XXX） ### COS-5001：拡張機能の読み込み失敗 **原因：** チェックアウト拡張機能をブラウザーで読み込めませんでした。 **解決方法：** * ブラウザーコンソールでJavaScriptエラーを確認 * 広告ブロッカーやプライバシー拡張機能を一時的に無効にする * ブラウザーのキャッシュを削除して再試行 * 別のブラウザーでテスト ### COS-5002：拡張機能の描画エラー **原因：** 拡張機能は読み込まれましたが、正しく表示できませんでした。 **解決方法：** * カスタムCSSの競合を確認 * 画像URLが有効で、アクセス可能かを確認 * 拡張機能の設定に無効な項目がないかを確認 ## さらにサポートが必要ですか？ [ ### よくある質問 よくある質問への回答 詳しく見る ](https://chargezen.com/ja/docs/checkoutos/troubleshooting/faq)[ ### サポートに問い合わせる 担当チームから個別のサポートを受ける 詳しく見る ](https://chargezen.com/ja/docs/checkoutos/troubleshooting/support) このページは役に立ちましたか？ さらにサポートが必要ですか？ [サポートに問い合わせる](https://chargezen.com/ja/docs/checkoutos/troubleshooting/support)