エラーコード

このリファレンスでは、CheckoutOSの利用中に発生する可能性のあるエラーコードを説明します。各エラーには、その意味と推奨する解決手順を記載しています。

原因： Shopifyストアへの接続を確立できません。

解決方法：

• ShopifyストアのURLが正しいかを確認
• Shopifyストアが有効で、一時停止や保留中でないことを確認
• Shopify App StoreからCheckoutOSアプリを再インストール
• Shopifyストアの管理者またはオーナー権限があることを確認

原因： CheckoutOSに必要な権限がありません。

解決方法：

• アプリを再インストールして権限を再承認
• ストアのオーナーまたは管理者としてログインしていることを確認
• Shopify Admin → Apps → CheckoutOSで権限の状態を確認

原因： Shopifyプランがチェックアウト拡張機能に対応していません。

解決方法：

• チェックアウトの拡張機能をすべて使うにはShopify Plusにアップグレード
• Checkout Extensibilityのベータアクセスを申請（Plus以外のストア）
• 購入後の機能のみを利用（すべてのプランで利用可能）

原因： キャンペーンに不足または無効な設定があります。

解決方法：

• キャンペーンの必須項目をすべて確認
• アップセル用の商品が少なくとも1つ選択されていることを確認
• 割引値が有効な範囲内かを確認

原因： キャンペーン内の商品が存在しないか、利用できません。

解決方法：

• Shopifyカタログから商品が削除されていないかを確認
• 商品が公開され、有効であることを確認
• キャンペーンを有効な商品IDで更新

原因： キャンペーンのターゲティングルールが互いに矛盾しています。

解決方法：

• ターゲティングルールのAND／ORの論理を確認
• 最小値と最大値が不適切に重複していないことを確認
• 不可能な条件がないかを確認（例：カート > US$100かつカート < US$50）

原因： アップセル商品に割引を適用できません。

解決方法：

• 競合するShopify割引コードがないかを確認
• Shopifyで割引の組み合わせ設定を確認
• 商品が割引対象から除外されていないことを確認

原因： アップセル商品の代金を顧客に請求できません。

解決方法：

• 通常はShopifyの決済ゲートウェイの問題
• Shopify Admin → Settings → Paymentsでゲートウェイの状態を確認
• 顧客は別の支払い方法で再試行する必要がある場合がある

原因： アップセル商品が在庫切れです。

解決方法：

• キャンペーン設定で在庫追跡の代替処理を有効にする
• 在庫切れに備えて代替商品を設定
• 適切な場合はShopifyで"Continue selling when out of stock"を設定

原因： APIリクエストが無効または期限切れのキーを使用しました。

解決方法：

• Dashboard → Settings → APIでAPIキーを再生成
• キーに入力ミスや空白がないかを確認
• キーに必要な権限があることを確認

原因： 短時間にAPIリクエストが多すぎます。

解決方法：

• アプリケーションにリクエストの流量制御を実装
• ポーリングの代わりにWebhookイベントを使用
• より高いレート制限が必要な場合はサポートに連絡

原因： Webhook署名の検証に失敗しました。

解決方法：

• WebhookシークレットがDashboard → Settings → APIと一致するかを確認
• 署名検証にリクエストの生の本文を使用していることを確認
• サーバーの時計が同期されていることを確認

原因： チェックアウト拡張機能をブラウザーで読み込めませんでした。

解決方法：

• ブラウザーコンソールでJavaScriptエラーを確認
• 広告ブロッカーやプライバシー拡張機能を一時的に無効にする
• ブラウザーのキャッシュを削除して再試行
• 別のブラウザーでテスト

原因： 拡張機能は読み込まれましたが、正しく表示できませんでした。

解決方法：

• カスタムCSSの競合を確認
• 画像URLが有効で、アクセス可能かを確認
• 拡張機能の設定に無効な項目がないかを確認