Appearance

준비하기 ​

개발 시 주의 사항을 설명해요.

CORS 허용을 위한 Origin 등록 ​

다음 도메인들을 Origin 허용 목록에 등록해 주세요

  • https://<appName>.apps.tossmini.com : 실제 서비스 런칭 시 사용
  • https://<appName>.private-apps.tossmini.com : 콘솔 QR 테스트 시 사용

iOS의 서드파티 쿠키 차단 정책 ​

iOS/iPadOS 13.4 이상에서는 서드파티 쿠키가 완전히 차단돼요.
앱인토스 도메인이 아닌 파트너사 도메인에서 쿠키 기반 로그인을 구현하면 정상 동작하지 않아요.

App Transport Security (ATS) ​

샌드박스 앱에서는 http 통신이 허용되지만, 라이브 환경은 https만 동작해요.
http 통신 기능은 샌드박스에서만 정상 동작한다는 점을 유의해주세요.

게임 리소스 분리 다운로드 권장 ​

앱인토스 미니앱의 빌드 파일은 압축 해제 기준 100MB 이하만 허용돼요.
빌드 파일에 모든 리소스(이미지, 사운드, 영상 등)를 포함하면 용량을 초과할 수 있어요.
필수적으로 리소스 다운로드를 빌드 파일과 분리해야 합니다.

  • 앱 실행에 꼭 필요한 최소 리소스만 빌드 파일에 포함하세요.
  • 대용량 리소스는 외부 스토리지/CDN을 통해 다운로드하도록 구성해 주세요.
  • 추가 리소스는 단계적 다운로드(Lazy Loading)를 적용하면 사용자 경험이 향상돼요.

외부 3자 로깅 솔루션 제한 ​

정책상 외부 3자 로깅 솔루션 사용은 제한돼요. 현재 허용되는 솔루션은 아래와 같아요.
추가 제안이 있으면 채널톡으로 보내주세요. 내부 검토 후 안내드릴게요.

[ 시스템 로거 ]

  • Sentry

[ 분석용 로거 ]

  • Google Analytics
  • Unity Analytics
  • Amplitudes (단, Webview 에서만 사용 가능)

비게임 미니앱은 '피처' 단위로 노출돼요 ​

미니앱 개발이 완료되면, 토스앱 내에서 피처(기능) 단위로 사용자에게 노출할 수 있어요.
하나의 서비스(앱)는 반드시 하나 이상의 피처를 가져야 하며, 최대 3개까지 등록할 수 있어요.

피처란? ​

토스 사용자에게 노출되는 기능 단위의 랜딩 페이지예요.

예:

  • 오늘의 운동 루틴 보기 → Page A로 이동
  • 식단 기록하기 → Page B로 이동
  • 건강 리포트 확인하기 → Page C로 이동

피처 등록 위치 ​

  • 최초 등록: 콘솔 > 앱 출시 > 검토 요청하기 단계
  • 이후 관리: 콘솔 > 앱 내 기능 탭에서 수정/추가

등록 시 피처 이름과 이동할 주소를 꼭 입력해주세요.

  • 기본 스킴: intoss://{appName} (하위 경로: intoss://{appName}/path)
  • 쿼리 파라미터 설정 가능
  • 제공 기능 단위로 세분화하여 등록
  • 최대 3개까지 등록 가능
  • 기능 이름은 ~기록하기, ~보러 가기 등 ‘~하기’ 형태 권장(명사형도 가능)

개발 환경별 피처 구성 ​

1. Webview ​

라우터 경로를 피처 주소와 매핑해요.

tsx
<Route path="/search" element={<SearchPage />} />

피처 주소는 intoss://{appName}/search로 입력하면 해당 페이지로 이동할 수 있어요.

2. React Native (Bedrock 기반) ​

Next.js 유사 파일 기반 라우팅을 사용해요.
/pages/search.tsx → /search 경로 매핑 → intoss://{appName}/search로 진입 시 렌더링
자세한 구조는 파일 기반 라우팅 이해하기 를 참고하세요.