테스트앱(샌드박스)
테스트앱(샌드박스)
앱인토스는 개발용 토스앱을 별도로 제공하지 않아요. 대신 전용 샌드박스 앱을 통해 개발·테스트 환경을 구성할 수 있어요.
샌드박스 앱이란?
앱인토스는 토스앱 안에서 파트너사의 서비스를 앱인앱(App-in-App) 형태로 제공해요. 별도의 개발용 토스앱 대신, 개발·QA 전용 샌드박스 앱을 통해 연동 테스트를 진행할 수 있어요.
샌드박스 앱을 설치한 뒤 아래 순서로 개발을 시작하세요.
환경 설정
샌드박스 앱 설치
로그인 → 앱 선택 → 스킴(URL) 접속
지원 OS 버전
Android
Android 7
iOS
iOS 16
1. 환경 설정하기
iOS 환경 설정
iOS 시뮬레이터에서 테스트하려면 Xcode가 필요해요.
1-1. Xcode 설치하기
Xcode 최신버전 다운로드를 클릭해서 Mac App Store에서 설치해 주세요.
1-2. iOS 컴포넌트 설치하기
Xcode를 처음 설치한 경우, iOS 15 이상의 컴포넌트를 추가로 설치해야 해요. 아래와 같은 창이 표시되면 iOS를 선택해 설치해 주세요.
1-3. Xcode Command Line Tools 설치하기
Xcode Command Line Tools는 Xcode 본체와 버전이 동일해야 해요.
Xcode 버전 확인하기
Xcode를 열고 상단 메뉴에서 [Xcode] > [About Xcode]를 클릭하세요.
화면에 표시된 버전을 확인하세요.
Xcode Command Line Tools 버전 확인하기
Xcode에서 [Xcode] > [Settings]를 클릭하세요.
[Locations] 탭에서 Command Line Tools 항목의 버전을 확인하세요.
1-4. 시뮬레이터 실행하기
Xcode 상단 메뉴에서 [Xcode] > [Open Developer Tool] > [Simulator]를 선택하세요.
iOS 15 이상의 버전을 사용할 수 있는지 확인하세요.
Android 환경 설정
React Native를 Android 환경에서 실행하려면 Android SDK와 adb(Android Debug Bridge)가 필요해요.
1-1. Android Studio 설치하기
Android Studio 설치 링크에서 설치해 주세요.
1-2. Android SDK Command-line Tools 설치하기
Android Studio에서 상단 메뉴 [Android Studio] > [Settings]를 클릭하세요.
[Languages & Frameworks] > [Android SDK]를 선택하세요.
[SDK Tools] 탭에서 "Android SDK Command-line Tools"를 체크하고 OK를 눌러 설치하세요.
1-3. 환경 변수 설정하기
adb를 사용하려면 환경 변수를 설정해야 해요.
환경 변수가 정상적으로 등록되었는지 아래 명령어로 확인하세요.
1-4. 기기 연결하기
개발자 옵션 활성화
갤럭시 기기 기준으로 아래와 같이 활성화해요.
[설정] 앱 열기
[휴대전화 정보] > [소프트웨어 정보] 메뉴로 이동
[빌드 번호] 항목을 빠르게 여러 번 탭하기
USB 디버깅 활성화
[설정] > [개발자 옵션] 메뉴로 이동해요.
[USB 디버깅] 항목을 활성화해요.
PC와 기기 연결하기
USB 케이블로 PC와 기기를 연결한 뒤, 아래 명령어로 연결 상태를 확인해요.
"List of devices attached" 아래에 디바이스 아이디가 표시되면 연결이 성공한 거예요.
1-5. 에뮬레이터 설정하기
⚠️ 디버깅과 QA는 가능한 실제 기기에서 진행하는 것을 권장해요.
Android Studio를 실행한 후 오른쪽 메뉴에서 [Virtual Device Manager] > [+ 버튼]을 눌러 에뮬레이터를 추가해요.
[Pixel 8a] > [VanillaIceCream (API 35)] > [AVD Name 설정] 순으로 진행하면 에뮬레이터 설정이 완료돼요.
추가된 에뮬레이터는 [Virtual Device Manager]에서 재생 버튼을 눌러 실행할 수 있어요.
2. 샌드박스 앱 설치하기
샌드박스 앱은 수시로 업데이트돼요. 오류가 보이면 최신 버전으로 업데이트해 주세요.
iOS에 설치하기
시뮬레이터
다운로드한 샌드박스 앱 파일을 시뮬레이터 화면으로 드래그 앤드 드롭하세요. 설치가 완료되면 앱이 시뮬레이터 홈 화면에 표시돼요. 설치 완료까지 잠시 기다려 주세요.
실기기
위 표의 QR 코드로 앱스토어에서 설치하세요.
Android에 설치하기
실제 기기와 에뮬레이터 모두 동일한 APK 파일을 사용해요.
Android Studio로 설치하기
Android Studio 오른쪽 메뉴 [Device Manager]에 연결된 기기가 표시되는지 확인해요.
[Start Mirroring] 버튼을 클릭해 기기 화면을 Android Studio에 표시해요.
다운로드한 APK 파일을 기기 화면으로 드래그해서 설치해요.
adb 명령어로 설치하기
3. 샌드박스 앱 사용하기
1. 개발자 로그인
콘솔에서 사용하는 토스 비즈니스 계정으로 로그인하세요. 토스 비즈니스 가입이 필요하다면 콘솔에서 앱 등록하기를 확인해 주세요.
2. 앱 선택
소속된 워크스페이스의 앱 목록이 노출돼요. 테스트할 앱을 선택하세요.
3. 토스 인증
콘솔에 등록한 토스 계정으로 본인 인증을 진행해요. 해당 계정의 토스앱이 설치된 스마트폰에서 푸시를 열어 인증을 완료해 주세요.
4. 스킴(URL)으로 접속
접속할 스킴을 입력하면 미니앱이 실행돼요.
4. 미니앱 실행하기
iOS 시뮬레이터에서 실행하기
샌드박스 앱을 실행해요.
스킴을 입력하고 "스키마 열기" 버튼을 눌러요. 예:
intoss://kingtoss
[동영상 보기](../../resources/development/local-server/local-develop-ios-sim-example.mp4)
iOS 실기기에서 실행하기
로컬 서버와 같은 와이파이에 연결되어 있어야 해요.
샌드박스 앱 실행 시 "로컬 네트워크" 권한 요청이 표시되면 "허용" 버튼을 눌러요.
서버 주소 입력 화면에서 로컬 서버 IP 주소를 입력하고 저장해요.
macOS에서는
ipconfig getifaddr en0명령어로 IP 주소를 확인할 수 있어요.
"스키마 열기" 버튼을 눌러요.
화면 상단에
Bundling {n}%...가 표시되면 연결 성공이에요.
Android 에뮬레이터 또는 실기기에서 실행하기
USB 케이블로 PC와 기기를 연결해요.
adb명령어로 포트를 연결해요.특정 기기를 연결하려면
-s옵션을 추가해요.샌드박스 앱에서 스킴을 입력하고 실행 버튼을 눌러요. 예:
intoss://kingtoss
[동영상 보기](../../resources/development/local-server/local-develop-android-example.mp4)
테스트 가능한 기능
샌드박스에서 지원하지 않는 기능은 콘솔 '출시하기'의 QR 코드로 토스앱에서 테스트해 주세요.
토스 로그인
✅ 가능
사용자 식별키 발급
✅ 가능 (단, mock 데이터 내려감)
토스페이
✅ 가능
인앱 결제
✅ 가능
게임 프로필 & 리더보드
✅ 가능
분석
❌ 불가능
공유 리워드
❌ 불가능
인앱 광고
❌ 불가능
가로 버전 게임
❌ 불가능
내비게이션 바 공유하기
❌ 불가능
자주 묻는 질문
트러블슈팅
마지막 업데이트
도움이 되었나요?