Apps in Toss is a platform that provides services developed by partner companies in an App-in-App form within the Toss app. It allows services to be exposed to 30 million Toss users.
Quick Reference
Platform Overview
- Supported OS: Android 7+, iOS 16+
- Users: Ages 19 and older
- Development method: WebView (Vite+React+TS) or React Native (Granite)
Core Features
| Feature | Description |
|---|---|
| Toss Login | OAuth2-based user authentication |
| TossPay | mTLS authentication-based payment system |
| In-app Payments | App Store / Google Play IAP |
| Push Notifications | Promotional/functional messages |
| Ads | Interstitial ads, rewarded ads |
| Promotions | Toss Point rewards |
Quick Start
WebView project:
npm create vite@latest my-app -- --template react-ts
cd my-app
npm install @apps-in-toss/web-framework @toss/tds-mobile
npx ait init
React Native (Granite) project:
npm create granite-app
cd my-granite-app
npm install @apps-in-toss/framework @toss/tds-react-native
npx ait init
API Base URLs
| Service | URL |
|---|---|
| Login/Messaging | https://apps-in-toss-api.toss.im |
| Payments | https://pay-apps-in-toss-api.toss.im |
| Authentication | https://cert.toss.im |
Module Index
This skill is organized into a modular structure. Refer to each module for details.
Getting Started
- modules/getting-started.md - Platform overview, onboarding, requirements, precautions
Development
- modules/development.md - WebView/React Native setup, debugging, client configuration, testing
Authentication
- modules/authentication.md - Toss Login, Game Login, Toss Authentication (OAuth2, API)
Payments
- modules/payment.md - TossPay, in-app payments, mTLS certificates
Marketing
- modules/marketing.md - Push notifications, ads, promotions, game center, analytics
Launch
- modules/launch.md - Review process, checklist, dark pattern prevention
Monetization
- modules/monetization.md - Revenue structure, settlement, Biz Wallet
Game Development
- modules/unity-guide.md - Unity WebGL mini-app development guide
- modules/cocos-guide.md - Cocos Creator mini-app development guide
TDS (Toss Design System)
- modules/tds-mobile.md - TDS Mobile (for WebView) component guide
- modules/tds-react-native.md - TDS React Native (for Granite) component guide
Example Code
- modules/examples-index.md - Official example code index (24+ examples)
Design
- design-guide.md - Branding, dark pattern prevention, UX writing, TDS
API Reference
- reference.md - Detailed API documentation, SDK reference, error codes
Key SDK Version Requirements
| Feature | SDK Version | Toss App Version |
|---|---|---|
| Basic Features | 1.0.0+ | - |
| In-app Ads | 1.0.3+ | - |
| In-app Payments | 1.1.3+ | 5.231.0+ |
| Toss Authentication | 1.2.1+ | 5.233.0+ |
| Game Login | 1.4.0+ | 5.232.0+ |
Development Flow
1. 콘솔에서 미니앱 생성
↓
2. 개발 환경 선택 (WebView / RN)
↓
3. SDK 설치 및 초기화
↓
4. 로컬 개발 및 테스트
↓
5. 샌드박스 앱에서 테스트
↓
6. 토스 앱에서 QR 테스트
↓
7. 번들 빌드 및 업로드
↓
8. 검수 (운영/디자인/기능/보안)
↓
9. 출시
Core Policies
Requirements
- TDS (Toss Design System) components must be used
- Light mode only (dark mode not supported)
- Toss Login only (third-party login prohibited)
- Toss Pay/in-app payment only (other payment methods prohibited)
- Bundle size 100MB or less
Dark patterns prohibited
- Do not display bottom sheet immediately upon entry
- Do not intercept back navigation
- UI without an exit option prohibited
- Unexpected ad exposure prohibited
- Ambiguous CTA buttons prohibited
Works Well With
- moai-lang-typescript: TypeScript development patterns
- moai-domain-frontend: React component development
- moai-domain-backend: API server development
- moai-domain-uiux: UI/UX design system
- moai-workflow-testing: Testing strategy
Resources
Official Documentation
- Developer Center: https://developers-apps-in-toss.toss.im
- SDK Reference: https://developers-apps-in-toss.toss.im/bedrock/reference
- Unity Guide: https://developers-apps-in-toss.toss.im/unity/intro/overview.html
- TDS Mobile: https://tossmini-docs.toss.im/tds-mobile/
- TDS React Native: https://tossmini-docs.toss.im/tds-react-native/
GitHub Examples
- Official Examples: https://github.com/toss/apps-in-toss-examples
- Cocos Examples: https://github.com/toss/apps-in-toss-cocos-examples
Skill Internal References
- Detailed API Documentation: reference.md
- Design Guide: design-guide.md
- Example Index: modules/examples-index.md
Status: Production Ready Version: 2.2.0 Last Updated: 2026-01-19 Platform: Apps in Toss Game Engines: Unity WebGL, Cocos Creator 3.8.7