用途:该技能面向 Apps in Toss(앱인토스)迷你应用开发。Apps in Toss 是合作伙伴开发的、以 App-in-App 形式运行在 Toss 应用内部的平台。技能按模块化结构组织,包含入门、开发、认证、支付、营销、发布、变现、游戏开发、TDS 组件与示例索引等模块,并附带 reference.md 与 design-guide.md。
主要能力:涵盖 Toss 登录(OAuth2)、TossPay(基于 mTLS 认证的支付)、应用内支付(App Store / Google Play IAP)、推送通知、广告(前贴片与激励广告)、促销(Toss 积分奖励),以及游戏登录、游戏中心、分析与收益结算、Biz Wallet 等。支持 WebView(Vite+React+TS)与 React Native(Granite)两种方式,也提供 Unity WebGL 与 Cocos Creator 3.8.7 的迷你应用开发指南。
使用方式:WebView 项目可执行 npm create vite@latest my-app -- --template react-ts,进入目录后执行 npm install @apps-in-toss/web-framework @toss/tds-mobile,再执行 npx ait init。React Native(Granite)项目可执行 npm create granite-app,进入目录后执行 npm install @apps-in-toss/framework @toss/tds-react-native,再执行 npx ait init。API 基础地址包括登录/消息 https://apps-in-toss-api.toss.im、支付 https://pay-apps-in-toss-api.toss.im、认证 https://cert.toss.im。
适用场景:在 Toss 应用内开发迷你应用、使用 Granite 框架、接入 TossPay 支付或开发基于 Unity WebGL / Cocos 的迷你游戏。
限制与要求:必须使用 TDS(Toss Design System)组件;仅支持浅色模式;仅可使用 Toss 登录(禁止第三方登录)与 TossPay/应用内支付(禁止其他支付方式);包体积不超过 100MB;禁止暗黑模式(Dark Pattern);不得在进入时立即弹出底部弹窗、拦截返回操作、提供无退出选项的 UI、弹出意外广告或使用含糊的 CTA 按钮。功能对 SDK 与 Toss 应用版本有最低要求,例如应用内广告需 SDK 1.0.3+、应用内支付需 SDK 1.1.3+ 与 Toss 应用 5.231.0+、Toss 认证需 SDK 1.2.1+ 与 5.233.0+、游戏登录需 SDK 1.4.0+ 与 5.232.0+。其他收费与价格信息暂未提供。