Appearance

자주 묻는 질문 ​

앱인토스 및 Bedrock 기반 미니앱을 개발하고 운영하면서 자주 묻는 질문들을 한 곳에서 확인하세요.

이해하기 ​

앱인토스는 파트너사가 개발한 서비스를 토스 앱 안에서 ‘앱인앱(App-in-App)’ 형태로 노출할 수 있게 하는 플랫폼이에요.

WebView 또는 React Native 기반 SDK를 통해 빠르고 효율적으로 서비스를 제공할 수 있어요.

토스 SDK와 API, UI 컴포넌트를 통해 로그인, 결제, 인증 등 핵심 기능을 빠르게 적용할 수 있어요.

디자인, 마케팅, 수익화, 정산까지 통합 솔루션을 제공합니다.

앱인토스는 만 19세 이상의 사용자를 대상으로 제공되며, Android 7 / iOS 16 이상 환경에서 이용할 수 있어요.

게임은 2~4주, 비게임은 2~3개월 정도 소요돼요.

기능 및 검수 절차에 따라 기간이 달라질 수 있어요.

콘솔 및 앱 등록 ​

사업자 등록 및 토스 비즈니스 회원 인증이 필요해요.

앱 이름, 아이콘, 서비스 설명 등 기본 정보와 번들을 준비해 주세요.

앱 ID는 등록 후 수정이 불가능하며, 등록된 앱은 삭제할 수 없어요.

보통 영업일 기준 1~2일이 소요돼요.

게임물관리위원회 또는 앱스토어/플레이스토어 심의를 완료해야 런칭할 수 있어요.

디자인 ​

네. 앱인토스 SDK와 의존성이 있어 필수로 설치해야 해요.

현재 라이트 모드만 지원하며 추후 업데이트 예정이에요.

개발자센터 > 디자인 > 피그마 섹션에서 다운로드할 수 있어요.

Bedrock ​

Bedrock은 React Native 기반의 앱인토스 전용 개발 프레임워크예요.

파일 기반 라우팅, SDK 통합, 자동 빌드 및 디버깅 기능을 제공해요.

Bedrock은 파일 기반 라우팅을 사용해요.

src/screens 내 파일이 자동으로 경로로 매핑돼요.

npx @toss/bedrock init 명령으로 새 프로젝트를 생성할 수 있어요.

package.json의 scripts.dev를 확인하세요.

"dev": "bedrock start"로 설정해야 해요.

앱인토스 도메인을 허용 목록에 추가해야 해요.

UI 컴포넌트가 정상 작동하지 않아요. TDS는 필수 의존성이에요.

개발 및 테스트 ​

appName과 granite 초기 설정을 확인하고 8081/5173 포트를 열어 주세요.

네. 검수 전에 반드시 진행해야 하며 테스트 미완료 시 반려될 수 있어요.

19세 이상, 워크스페이스 멤버, 토스 로그인 완료 조건을 모두 충족해야 해요.

API / 보안 / 로그인 ​

네. 앱인토스 API는 mTLS를 필수로 요구해요. 미적용 시 ERR_NETWORK 오류가 발생해요.

iOS 13.4 이상에서는 서드파티 쿠키가 차단돼요. 토큰 기반 인증을 사용하세요.

푸시, 결제, 프로모션 등 일부 API 사용 시 사용자 인증을 위해 필수예요.

토스는 사용자 정보를 삭제하고 서비스 측에서 세션/토큰을 초기화해야 해요.

데이터 분석 ​

서비스 런칭 하루 뒤부터 대시보드에서 확인할 수 있어요.

아니요. 실제 런칭된 서비스 데이터만 표시돼요.

개발자 커뮤니티를 통해 요청할 수 있어요.

결제 / 수익화 ​

서류 제출 후 영업일 기준 7~14일이 소요돼요.

테스트 키로는 결제 생성까지만 가능하며 승인 처리는 불가해요.

최소 400원, 최대 1,400,000원까지 설정할 수 있어요.

  • Google Play: 48시간 이내 자동 처리, 이후 수동 요청 가능
  • App Store: 모든 환불은 Apple이 직접 처리

마케팅 / 프로모션 ​

검수 승인 후 발송 가능하며, 야간/민감정보 노출은 제한돼요.

영업일 기준 2~3일 소요돼요.

네. TEST_{promotionCode}로 테스트를 완료해야 검수가 통과돼요.

정산 / 세금 ​

정산은 월 단위로 진행되며, 콘솔에서 세부 일정을 확인할 수 있어요.

콘솔 내 정산 > 서류 메뉴에서 다운로드할 수 있어요.

계약 조건에 따라 달라지며, 계약서 내용을 따릅니다.

운영 / 지원 / 보안 ​

채널톡에서 문의할 수 있어요. 빠른 대응을 위해 에러 로그/스크린샷을 함께 남겨 주세요.

즉시 채널톡으로 보고 후 임시 조치 및 영향평가를 진행해 주세요.

안정성 확보를 위해 요청 빈도 제한이 있어요. 재시도 시 지수 백오프를 구현해 주세요.

마이너 변경은 하위 호환 유지, 메이저 변경은 사전 공지 및 유예기간이 제공돼요.

홍보 / 브랜드 가이드 ​

공식 가이드에 따라 색상, 비율을 변경하지 않고 사용해야 해요.

아니요. “토스 제휴”로 표기해야 하며 사전 승인 후 배포해야 해요.