--- title: "일반적인 문제: CheckoutOS 문서 | Chargezen" description: "자주 발생하는 CheckoutOS 문제의 해결 방법. Chargezen CheckoutOS 문서의 문제 해결 섹션에 있어요." url: "https://chargezen.com/ko/docs/checkoutos/troubleshooting/common-issues" lang: "ko" updated: "2025-01-16" --- Canonical URL: https://chargezen.com/ko/docs/checkoutos/troubleshooting/common-issues # 일반적인 문제 자주 발생하는 CheckoutOS 문제의 해결 방법 마지막 업데이트: 2025-01-16 이 가이드에서는 CheckoutOS 사용자가 가장 자주 겪는 문제와 해결 방법을 다뤄요. 여기에서 문제를 찾지 못했다면 [오류 코드](https://chargezen.com/ko/docs/checkoutos/troubleshooting/error-codes) 참조를 확인하거나 [지원팀에 문의하세요](https://chargezen.com/ko/docs/checkoutos/troubleshooting/support). ## 추가 판매가 표시되지 않아요 구매 후 추가 판매가 결제 뒤에 나타나지 않는다면 다음을 확인하세요. 1 #### 캠페인 활성화 확인 2 #### 타기팅 규칙 확인 3 #### Shopify 연동 확인 4 #### 실제 주문으로 테스트 빠른 테스트 모든 고객에게 표시되도록 타기팅 규칙 없이 캠페인을 만들고 저가 상품에 100% 할인을 적용하세요. 테스트 주문으로 흐름이 작동하는지 확인하세요. ## 결제 확장 기능이 표시되지 않아요 신뢰 배지, 진행 표시줄 또는 다른 결제 확장 기능이 보이지 않는다면 다음을 확인하세요. ### Shopify Plus 요구 사항 기본 결제 확장 기능에는 다음 중 하나가 필요해요. * Shopify Plus 요금제 또는 * Checkout Extensibility 베타 접근 권한(일부 Plus가 아닌 스토어에서 사용 가능) Shopify Admin → Settings → Plan에서 요금제를 확인하세요. ### 확장 기능 위치 확장 기능이 보이는 위치에 배치되어 있는지 확인하세요. 1. Shopify Admin → Settings → Checkout → Customize로 이동하세요 2. 사용 가능한 블록에서 CheckoutOS 확장 기능을 찾으세요 3. 결제 레이아웃에서 원하는 위치로 드래그하세요 4. 변경 사항을 저장하고 미리 보세요 ## 할인 충돌 CheckoutOS 할인은 기존 Shopify 할인이나 다른 앱의 할인과 충돌할 수 있어요. 일반적인 증상은 다음과 같아요. * 추가 판매 할인이 적용되지 않아요 * 잘못된 할인 금액이 표시돼요 * 여러 할인이 예상치 않게 중복 적용돼요 할인 중복 적용 Shopify는 할인 조합을 제한해요. 고객이 이미 할인 코드를 적용했다면 CheckoutOS 추가 판매 할인이 적용되지 않을 수 있어요. **Dashboard → Settings → Discount Functions**에서 할인 규칙을 설정하세요. ### 해결 단계 1 #### 활성 할인 검토 2 #### 할인 조합 설정 확인 3 #### CheckoutOS 우선순위 설정 ## 느린 로딩 또는 시간 초과 CheckoutOS 기능이 느리게 로드되거나 시간 초과가 발생한다면 다음을 확인하세요. ### 네트워크 문제 * 인터넷 연결이 안정적인지 확인하세요 * 브라우저 캐시와 쿠키를 삭제해 보세요 * 시크릿 또는 비공개 창에서 테스트하세요 * 브라우저 확장 프로그램을 일시적으로 비활성화하세요 ### 앱 충돌 다른 Shopify 앱이 가끔 CheckoutOS와 충돌할 수 있어요. * 결제 관련 다른 앱을 일시적으로 비활성화하세요 * 브라우저 개발자 콘솔에서 JavaScript 오류를 확인하세요 * 최근 설치한 앱 중 결제에 영향을 줄 수 있는 앱을 검토하세요 JavaScript 오류 확인 ```javascript // Open browser developer tools (F12) and check the Console tab // Look for errors mentioning: // - chargezen // - checkoutos // - checkout-extension // Common error patterns: // "Failed to load resource" - Network/CORS issue // "undefined is not a function" - JavaScript conflict // "Extension blocked" - CSP or ad blocker issue ``` ## 분석 데이터가 추적되지 않아요 대시보드에 데이터가 없거나 잘못된 지표가 표시된다면 다음을 확인하세요. ### 데이터 지연 대시보드 지표는 15분 지연돼요. 실시간 데이터는 실시간 업데이트를 제공하는 Analytics 섹션을 사용하세요. ### 추적 확인 1 #### 연동 상태 확인 2 #### 웹훅 상태 검토 3 #### 테스트 주문하기 ## 모바일 표시 문제 모바일 기기에서 CheckoutOS 기능이 올바르게 표시되지 않는다면 다음을 확인하세요. * 브라우저 에뮬레이션뿐 아니라 실제 기기에서도 테스트하세요 * Dashboard → Settings → Store → Mobile Behavior에서 모바일 전용 설정을 확인하세요 * 맞춤 CSS에 모바일 분기점 문제가 있는지 검토하세요 * Shopify 테마가 모바일 반응형인지 확인하세요 ## 문제가 계속되나요? [ ### 오류 코드 특정 오류 코드와 의미를 찾아봐요 자세히 보기 ](https://chargezen.com/ko/docs/checkoutos/troubleshooting/error-codes)[ ### 지원팀 문의 지원팀의 도움을 받아요 자세히 보기 ](https://chargezen.com/ko/docs/checkoutos/troubleshooting/support) 이 페이지가 도움이 되었나요? 도움이 더 필요하신가요? [고객 지원 문의](https://chargezen.com/ko/docs/checkoutos/troubleshooting/support)