문제 해결 및 지원#

Visualizer SDK 연동에서 실패한 단계부터 확인하세요. SDK 로딩, 상품 매칭 또는 데이터 가져오기 중 어디에서 문제가 발생했는지 살펴보세요. 인증 정보를 공유하지 않으면서 요청 관련 정보를 보관하세요.

스토어 버튼이 표시되지 않음#

1. 네트워크 패널에서 https://sdk.ideal.house/sdk.js를 확인하고 로딩 실패 내역을 검사하세요.
2. 올바른 Shop ID와 Publishable Key를 사용하는 로더가 하나만 있는지 확인하세요.
3. Dashboard → Settings를 여세요. **Allowed Origins (CORS)**에 테스트 중인 정확한 스토어 출처가 포함되어 있는지 확인하고, 변경 후 저장을 클릭한 다음 스토어를 새로고침하세요. 대상 요소의 정확한 data-product-code도 확인하세요. 출처 설정을 참고하세요.
4. 상품이 준비되어 있고 선택한 상품 옵션에 매핑이 있는지 확인하세요.
5. 직접 작성한 버튼은 검증된 활성 상태에서 표시되도록 스타일이 설정되어 있는지 확인하세요.

사용 요건 검증을 우회하기 위해 검증되지 않은 버튼을 강제로 표시하지 마세요. 플랫폼 가이드와 매핑 가이드를 따르세요.

잘못된 상품이 열림#

상품 옵션을 바꾸거나 빠른 보기를 열거나 새로고침 없이 이동한 후 대상 요소를 검사하세요. 동적 페이지에 따라 오래된 SDK 속성을 제거하고 플랫폼 콜백이 실제로 실행되는지 확인하세요.

가져오기가 접수되었지만 상품이 없음#

202 Accepted 응답은 비동기 처리를 시작합니다. 작업 상태를 읽고 항목별 실패 내역을 확인한 다음 오류 및 재시도를 참고하세요. 상태 엔드포인트는 스토어의 현재 또는 가장 최근 작업을 반환합니다. 임의의 작업 ID로 이력을 조회하는 기능이 아닙니다.

지원팀에 전달할 정보#

초기 설정 과정에서 안내받은 지원 채널 또는 계정의 문의 기능을 사용하세요. 문제가 발생한 스토어 URL, 관련된 경우 Shop ID, 상품 코드 또는 가져오기 작업 ID, 대략적인 시간, 브라우저, 예상 결과 및 민감한 정보를 제거한 오류 응답을 포함하세요. 로그나 스크린샷을 공유하기 전에 Client Secret, API 키, 토큰 및 비공개 고객 이미지를 제거하세요.