Ait 빌드 콘솔 등록 버전을 샌드박스 앱에서 테스트하는 방법

개발
,
1

이 글의 성격은 무엇인가요?

질문 / 문제 해결

내용을 설명해주세요

안녕하세요.

ait로 빌드해서 토스 콘솔에 버전 등록까지 완료한 상태인데,
샌드박스 앱에서 실결제 없이 결제 흐름을 테스트하고 싶어서 문의드립니다.

개발 환경: WebView (React + Vite SPA)
사용 중인 SDK 버전: @apps-in-toss/web-framework 2.9.2
테스트 환경: iOS 실기기

현재 상황:

  1. npx ait build 로 빌드 완료
  2. 토스 콘솔 “앱 출시” 메뉴에서 ait 파일 버전 등록 완료
  3. 콘솔에서 발급된 테스트 QR로 실제 토스 앱에서 접속 시 실결제 발생
    (채널톡 문의 결과 "QR코드 테스트 시 실결제 발생이 맞다"고 안내받음)
  4. 채널톡에서 "최신 샌드박스 앱에서는 별도 실결제 없이 테스트 가능하다"고 안내받아 샌드박스 앱 설치 후 시도 중

문제:
샌드박스 앱을 설치하고 개발자 로그인 후,
intoss://tarotsignal 스킴으로 접속을 시도하면
"로컬서버를 찾을 수 없습니다 / 로컬서버를 실행해주세요“ 에러만 계속 떠요.

저는 npm run dev로 로컬 개발 서버를 띄운 상태가 아니라, 이미 ait build로 빌드 완료해서 콘솔에 버전 등록까지 마친 상태입니다.

질문:
최신 샌드박스 앱에서 콘솔에 등록한 ait 빌드 버전을
실결제 없이 테스트하려면 정확히 어떤 절차로 진행해야 하나요?
단계별로 알려주시면 감사하겠습니다.

감사합니다.

appName (선택)

tarotsignal

2

@yjy0365 님 안녕하세요

가이드 안내드립니다.

3

답변 감사합니다.

해당 문서는 이미 확인했는데, 로컬 개발 서버(npm run dev) 없이
ait build로 콘솔에 등록한 버전을 샌드박스에서 여는 방법을
구체적으로 여쭤보고 싶습니다.

현재 상황:

  • 개발 환경: WebView (React + Vite SPA)
  • npx ait build 완료 후 토스 콘솔에 버전 등록까지 마친 상태
  • 로컬 개발 서버는 실행하지 않은 상태

문서에 나온 intoss://tarotsignal 스킴으로 접속하면
“로컬서버를 찾을 수 없습니다” 에러만 뜨고,
콘솔에 등록된 배포 버전으로 연결이 안 되는 상황이에요.

혹시 ait 빌드 버전을 샌드박스에서 열 수 있는
별도 스킴이나 절차가 있나요?
아니면 WebView 방식은 샌드박스가 로컬 서버 전용이라
콘솔 등록 버전은 테스트 QR(실결제)로만 확인 가능한 건가요?

감사합니다.

4

안녕하세요 :slight_smile:
npm run dev로 로컬 개발 서버 실행 후, 샌드박스앱에서 접근해주시면 테스트가 가능해요.

실기기로 접근하신다면, 로컬 서버 실행 전에 위 가이드에 따라 ip 를 입력해주세요.