미니앱 가이드라인

앱인토스 미니앱 서비스 기획 전에 참고할 수 있는 기능과 가이드를 정리한 페이지예요.
아래 내용을 지키지 않으면 미니앱 출시 전에 수정 사항이 발생할 수 있어요.

제한된 콘텐츠

아래에 소개된 콘텐츠가 포함된 미니앱은 앱인토스 서비스에 입점할 수 없어요.

1. 불법성

토스는 사용자에게 안전하고 신뢰할 수 있는 서비스를 제공하기 위해, 불법적인 콘텐츠의 입점을 허용하지 않아요.

법령에 위반되거나 위법 소지가 있는 콘텐츠는 미니앱에서 제공할 수 없기 때문에, 아래와 같은 불법성 콘텐츠가 포함되어 있는지 확인이 필요해요.

• 불법 사행성 게임, 도박, 복권 판매 등
• 마약, 대마, 향정신성 의약품 등 관련 거래 또는 정보 제공
• 불법 저작물 공유 또는 판매
• 타인의 개인정보를 무단으로 수집하거나 유출하는 행위
• 법적으로 허용되지 않은 금융 상품이나 투자 상품을 중개 또는 광고하는 행위
• 그 외 관계 법령 또는 관련 기관의 규제를 위반하는 콘텐츠

2. 불건전

사용자에게 불쾌감을 줄 수 있거나, 사회적·윤리적으로 부적절한 콘텐츠는 미니앱에 입점할 수 없어요.
다음과 같은 사례가 이에 해당돼요.

• 음란하거나 선정적인 이미지, 영상, 텍스트 등
• 혐오감을 유발하거나 차별적인 표현이 포함된 콘텐츠
• 폭력적이거나 자극적인 소재를 과도하게 사용하는 콘텐츠
• 미확인 루머, 음모론, 비방 등 신뢰할 수 없는 정보
• 청소년 보호법, 정보통신망법 등 관련 법령에 저촉될 수 있는 내용
• 사회적 물의를 일으킬 가능성이 높은 주제

3. 사행성

사용자에게 책임 있는 서비스를 제공하기 위해서, 사행성의 콘텐츠의 입점도 제한하고 있어요.
특히 사용자의 금전적 손실을 유도하거나 과도한 몰입을 유발할 수 있는 사행성 게임 콘텐츠는 미니앱에서 제공할 수 없어요.

• 승패 또는 결과에 따라 보상을 제공하며 반복 사용 및 중독 요소가 있는 콘텐츠
• 실제 현금 또는 이에 준하는 수단을 걸고 진행하는 콘텐츠
• 그 외 도박적 성격이 있다고 판단될 수 있는 콘텐츠

4. 게임 연령 제한

다양한 연령대의 사용자가 안심하고 미니앱을 사용할 수 있도록, 게임 콘텐츠에 대한 연령 등급 기준을 적용하고 있어요.
게임물관리위원회 또는 관련 기관 심의 결과가 17세 이용가 또는 그 이상(청소년 이용불가 등)으로 분류된 게임은 앱인토스에 입점할 수 없어요.

5. 자사 앱 설치 유도

토스 미니앱은 별도의 앱 설치 없이 서비스를 이용할 수 있는 플랫폼이에요.
따라서 이용자에게 특정 모바일 앱의 설치를 유도하거나 권유하는 콘텐츠는 허용되지 않습니다.
또한, 자사 웹페이지로의 유도 역시 앱 설치 유도와 유사한 행위로 간주되어 제한될 수 있습니다.

토스가 제공하는 기능

1. 간편 로그인

간편 로그인(토스 로그인) 기능을 통해 토스 유저와 앱인토스 앱 유저를 같은 유저로 연결할 수 있어요.
콘솔에서 필요한 개인정보 항목을 설정하여 토스 로그인으로 회원을 연동할 수 있어요.
토스 로그인을 통해 유저의 이름, 휴대폰 번호, 생년월일, 식별 키, 성별, 국적, 이메일을 받을 수 있어요.

2. 간편 결제

간편 결제(토스페이)를 통해 결제를 사용할 수 있어요.
단건 결제 서비스만 제공하고 있으며, 추후 정기 결제도 추가될 예정이에요. 결제 항목에 따라 간편결제(토스페이) 또는 인앱결제(IAP)가 가능해요.

• 실물 재화/서비스가 제공되는 경우: 간편결제(토스페이) 연동
• 비실물 재화/서비스(게임 아이템, 구독 형태의 이용권 등)가 제공되는 경우: 인앱결제(IAP) 연동

3. 광고 수익화

광고 수익화(IAA, 인앱광고)는 전면형, 보상형 두 가지 방식으로 제공돼요.

• 전면형 광고: 사용자의 콘텐츠 흐름을 일시적으로 차단하고 전체 화면에 광고를 노출하는 방식으로, 주로 화면 전환 시점에 활용돼요.
• 보상형 광고: 사용자가 광고를 자발적으로 시청한 대가로 앱 내 보상을 제공하는 방식이에요. 사용자 참여를 기반으로 활용돼요.

추후 배너형 등 다른 유형의 광고도 추가될 예정이에요.

4. 푸시 발송

토스의 푸시 발송(메시지) 기능을 통해 기능형 메시지와 광고형 메시지를 보낼 수 있어요.

• 기능형 메시지 : 미니앱의 주요 기능이나 서비스 흐름에 필요한 정보를 사용자에게 전달할 수 있어요.
• 광고형 메시지 : 특정 상품, 서비스, 혜택 등을 알리거나 구매 및 이용을 유도하는 메시지

5. 토스 포인트 지급

콘솔(관리자 서비스)에서 토스 포인트 지급(프로모션) 을 설정하고 진행할 수 있어요. 비즈 월렛을 충전하고, 프로모션 예산을 등록하여 관리할 수 있어요.

앱인토스는 앞으로도 다양한 솔루션을 지속적으로 제공드릴 예정이에요.

비게임 미니앱은 토스앱에서 피처 단위로 노출돼요

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

피처란 무엇인가요?

피처는 토스 사용자에게 노출할 기능 단위의 랜딩 페이지를 의미해요.
예를 들어, 건강 관리 미니앱이라면 다음과 같이 나눌 수 있어요:

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

피처 등록은 어디서 하나요?

최초 등록은 콘솔의 앱 출시의 검토 요청하기 단계에서 가능해요.
이후에는 '앱 내 기능' 탭을 통해 등록한 피처를 수정하거나 추가할 수 있어요.

토스앱의 미니앱 홈에서 사용자들이 미니앱을 쉽게 찾아갈 수 있도록, 피처 이름과 이동할 주소를 꼭 입력해 주세요.

• 이동할 주소는 기본적으로 intoss://{appName} 형식을 사용하며, intoss://{appName}/path 형식으로 하위 경로를 입력할 수 있어요.
• 쿼리 파라미터도 함께 설정할 수 있어요.
• 사용자에게 제공하고자 하는 기능 단위로 세분화해 설정해 주세요.
• 최대 3개까지 등록이 가능해요.
• 기능 이름은 ~기록하기, ~보러 가기와 같이 '~하기' 형태를 권장해요. 명사형도 가능해요.

개발 환경별 피처 등록 방식

피처는 사용자가 진입하게 될 기능 단위의 진입점이에요.
각 개발환경에서 아래 기준에 따라 피처 URL을 구성해 주세요.

1. Webview

WebView 환경에서는 intoss://{appName}/경로에 대응되는 화면이 라우터에서 정의한 경로와 매핑돼요.

예를 들어, 다음과 같이 라우터를 구성한 경우:

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

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

2. React Native (Bedrock 기반)

React Native Bedrock 환경에서는 Next.js와 유사한 파일 기반 라우팅 구조를 사용해요.
특정 경로에 파일을 만들면 자동으로 라우팅이 구성돼요.

예를 들어, /pages/search.tsx 파일을 만들면 /search 경로로 매핑돼요.
따라서 intoss://{appName}/search로 진입하면 해당 파일이 랜더링돼요.

자세한 구조는 파일 기반 라우팅 이해하기 를 참고해 주세요.

개발 시 유의사항

CORS 허용을 위한 Origin 등록 안내

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

• https://<appName>.apps.tossmini.com : 실제 서비스 런칭 시 사용되는 URL이예요.
• https://<appName>.private-apps.tossmini.com : 출시하기 메뉴에서 QR코드 테스트 시 사용되는 URL이예요.

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

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

• 서드파티 쿠키에 대한 공식 안내는 이 링크를 참고해 주세요.
• 쿠키 기반 인증이 아닌 토큰 기반 등 다른 인증 방식을 적용해 주세요.

App Transport Security 정책 안내

App Transport Security 정책 위반 방지를 위해, 샌드박스 앱에서는 http 통신이 허용돼요.
단, 라이브 환경에서는 https로만 동작하므로 http 통신을 사용하는 기능은 샌드박스 환경에서만 정상 동작해요.

참고사항

세로형/가로형 콘텐츠 지원

세로형 콘텐츠와 가로형 콘텐츠 모두 지원하고 있어요.

TDS 라이트 모드 지원

현재 앱인토스 TDS 시스템은 라이트 모드만 지원하고 있어요.
라이트 모드를 기준으로 미니앱을 기획하고 디자인해 주세요.
다크 모드는 추후 지원될 예정이에요.

잠시만요

TDS를 사용하지 않고 다크 모드를 개발하셔도 미니앱 런칭이 가능해요.

외부 링크 유도

앱인토스 미니앱은 토스 앱 내에서 모든 서비스를 제공해야 합니다.
외부 링크는 반드시 필요한 경우에만, 정말 불가피한 상황에서만 제한적으로 사용해야 합니다.

다음과 같은 형태의 외부 유도는 허용되지 않습니다:

• 외부 결제창 또는 앱 다운로드 페이지로 이동시키는 행위
• 미니앱이 제공하는 서비스와 관계없이 사용자를 토스 앱 밖으로 유도하는 구조

사용자를 토스 앱 외부로 이탈시키는 흐름은 이용 경험을 저해하고, 운영 가이드 위반으로 제재될 수 있습니다.

외부 3자 로깅 솔루션 사용 제한

앱인토스는 정책상 외부 3자 로깅 솔루션 사용을 제한하고 있습니다.
현재 사용 가능한 솔루션을 안내드려요. 이외에 추가로 제안주고 싶으신 솔루션이 있다면 채널톡으로 말씀해주세요.
내부적으로 검토를 거쳐 안내드릴게요.

[ 시스템 로거 ]

• Sentry

[ 분석용 로거 ]

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