일반적인 문제: CheckoutOS 문서

이 가이드에서는 CheckoutOS 사용자가 가장 자주 겪는 문제와 해결 방법을 다뤄요. 여기에서 문제를 찾지 못했다면 오류 코드 참조를 확인하거나 지원팀에 문의하세요.

추가 판매가 표시되지 않아요

구매 후 추가 판매가 결제 뒤에 나타나지 않는다면 다음을 확인하세요.

캠페인 활성화 확인

타기팅 규칙 확인

Shopify 연동 확인

실제 주문으로 테스트

빠른 테스트

모든 고객에게 표시되도록 타기팅 규칙 없이 캠페인을 만들고 저가 상품에 100% 할인을 적용하세요. 테스트 주문으로 흐름이 작동하는지 확인하세요.

결제 확장 기능이 표시되지 않아요

신뢰 배지, 진행 표시줄 또는 다른 결제 확장 기능이 보이지 않는다면 다음을 확인하세요.

Shopify Plus 요구 사항

기본 결제 확장 기능에는 다음 중 하나가 필요해요.

Shopify Plus 요금제 또는
Checkout Extensibility 베타 접근 권한(일부 Plus가 아닌 스토어에서 사용 가능)

Shopify Admin → Settings → Plan에서 요금제를 확인하세요.

확장 기능 위치

확장 기능이 보이는 위치에 배치되어 있는지 확인하세요.

Shopify Admin → Settings → Checkout → Customize로 이동하세요
사용 가능한 블록에서 CheckoutOS 확장 기능을 찾으세요
결제 레이아웃에서 원하는 위치로 드래그하세요
변경 사항을 저장하고 미리 보세요

할인 충돌

CheckoutOS 할인은 기존 Shopify 할인이나 다른 앱의 할인과 충돌할 수 있어요. 일반적인 증상은 다음과 같아요.

추가 판매 할인이 적용되지 않아요
잘못된 할인 금액이 표시돼요
여러 할인이 예상치 않게 중복 적용돼요

할인 중복 적용

Shopify는 할인 조합을 제한해요. 고객이 이미 할인 코드를 적용했다면 CheckoutOS 추가 판매 할인이 적용되지 않을 수 있어요. Dashboard → Settings → Discount Functions에서 할인 규칙을 설정하세요.

해결 단계

활성 할인 검토

할인 조합 설정 확인

CheckoutOS 우선순위 설정

느린 로딩 또는 시간 초과

CheckoutOS 기능이 느리게 로드되거나 시간 초과가 발생한다면 다음을 확인하세요.

네트워크 문제

인터넷 연결이 안정적인지 확인하세요
브라우저 캐시와 쿠키를 삭제해 보세요
시크릿 또는 비공개 창에서 테스트하세요
브라우저 확장 프로그램을 일시적으로 비활성화하세요

앱 충돌

다른 Shopify 앱이 가끔 CheckoutOS와 충돌할 수 있어요.

결제 관련 다른 앱을 일시적으로 비활성화하세요
브라우저 개발자 콘솔에서 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 섹션을 사용하세요.

추적 확인

연동 상태 확인

웹훅 상태 검토

테스트 주문하기

모바일 표시 문제

모바일 기기에서 CheckoutOS 기능이 올바르게 표시되지 않는다면 다음을 확인하세요.

브라우저 에뮬레이션뿐 아니라 실제 기기에서도 테스트하세요
Dashboard → Settings → Store → Mobile Behavior에서 모바일 전용 설정을 확인하세요
맞춤 CSS에 모바일 분기점 문제가 있는지 검토하세요
Shopify 테마가 모바일 반응형인지 확인하세요

문제가 계속되나요?

오류 코드

특정 오류 코드와 의미를 찾아봐요

지원팀 문의

지원팀의 도움을 받아요