非游戏上线指南

这是适用于迷你应用的通用标准和各功能的上线指南。上线前请务必确认内容并遵守指南。

如果未遵守以下检查清单，或发现存在暗黑模式，审核将不会通过；即使在上线后发现，也可能限制服务展示或中止服务。

请参考

以下上线指南条目会持续更新。

接入及应用内功能

• 迷你应用可以正常打开。
• 在“应用内功能”中介绍的所有服务功能，在迷你应用中也可以以相同方式使用。
• 在“应用内功能”中注册的 scheme 可以正常连接。
• 通过应用 scheme 进入后，返回按钮可以正常工作。

导航栏

• 正在使用 Apps in Toss 导航栏。
• 如果显示返回按钮，在所有页面上都能正常工作。
• 如果在导航栏中显示应用名称和徽标，则使用在应用信息中注册的品牌徽标和迷你应用名称（韩文）。
• 如果显示首页按钮，则可正常工作。（可选）
• 迷你应用功能按钮最多只显示 1 个。（可选）
• Toss 导航栏的返回按钮与迷你应用中自行实现的返回按钮不会同时显示。
• 在更多按钮（⋯）中可以正常提供 Toss 通用功能（举报、分享等）。
• 显示关闭按钮和返回按钮，且其行为明确。
• 在初始页面按返回时，迷你应用会结束。

用户识别键发放

• 确认并保存用户标识符值，迷你应用可以正常启动。
• 用户的迷你应用使用记录会保留。
• 即使退出迷你应用后再次进入，所需数据也会保留。

安全与稳定性

• 不能使用执行从外部传入代码的功能。（例如： eval 等）
• 不能通过操作浏览器历史记录将用户导向自家网站。（例如： window.location.replace 等）
• 不能使用服务端渲染（SSR）。只能使用客户端渲染（CSR）或静态站点生成（SSG）方式。
• 如果使用 WebSocket，则仅使用加密的 wss:// 连接。（例如：Firebase Firestore、Supabase Realtime 等）
• API 通信仅使用加密的 HTTPS 连接。
• 用户登录信息、支付（Toss Pay、应用内支付）记录等敏感信息必须加密后存储到 DB 中。
• 将个人信息从客户端传送到自有服务器时，也建议加密。

服务使用行为

• 按下 Android 系统返回键时，会返回上一页或退出迷你应用。
• 除地图等必要情况外，基于手势的放大·缩小功能会被禁用。
• 迷你应用主题以亮色模式实现。
• 所有 UI 组件都按预期运行。
• 滚动、触摸、页面切换等交互响应不会延迟超过 2 秒。
• 即使退出迷你应用后再次进入，所需数据也会保留。
• 服务使用必需的外部链接可以正常打开。
• 在分享功能中 intoss-private:// 不使用链接 intoss:// scheme。
• 迷你应用文案中不包含脏话、俚语或过度流行语。
• 不包含违法性、色情性等非法内容。
• 位置、通知等设备权限会先征得用户同意。
• 即使用户不授予权限，其余功能也会继续正常运行。
• 不会异常增加网络使用量。
• 不会异常增加内存使用量。

UX

• 刚进入迷你应用时，不会自动打开底部弹窗。
• 在特定页面切换时，不会通过底部弹窗强制引导用户操作。
• 在所有页面中，用户离开迷你应用的方法都很明确。
• 看到 CTA 按钮时，可以预测下一步会发生什么操作。
• 不会通过链接或组件诱导跳转到自家服务或安装自家应用。
• 应用内广告不会出现在 Intro/加载/过场动画/弹窗模态等临时画面中。
• 不会误导或强制引导用户点击应用内广告。

Toss 登录

• 使用 Toss 登录时，会在 Intro 页面提供服务说明，让用户了解这是哪种服务。
• 设置的 Toss 登录条款页面 URL 可以正常显示。
• 在 Toss 应用中解除登录关联后，再次进入迷你应用时，会显示重新登录请求的条款页面。
• 在 Toss 应用中解除登录关联后，用户数据不会留在迷你应用中。
• 不提供非 Toss 登录的自家登录或其他登录方式。

应用内支付

• 进行应用内支付时，迷你应用中正在播放的音乐会暂停。
• 应用内支付订单金额与 Google 或 Apple 支付窗口中显示的金额一致。
• 应用内支付可以正常进行。也会在 Google 支付测试环境中确认。
• 应用内支付完成后返回迷你应用时，支付结果会正常反映。
• 在应用内支付窗口中选择取消，会返回订单页面。
• 因余额不足等原因支付失败时，用户可以知道失败原因。
• 应用内支付取消会正常处理。
• 用户可以查看应用内支付商品的支付记录。
• 即使更换登录 Toss 应用的设备，先前已支付的应用内支付数据（如使用券等）也会保留。

Toss Pay

• 进行 Toss Pay 便捷支付时，迷你应用中正在播放的音乐会暂停。
• 订单金额与 Toss Pay 支付窗口中显示的金额一致。
• Toss Pay 支付失败时会显示错误信息，用户可以知道失败原因。
• 在 Toss Pay 支付前一刻选择取消，会返回上一页面。
• 不提供 Toss Pay 以外的其他支付方式。
• 在 Toss Pay 支付窗口中选择取消，会进入订单页面。

应用内广告

• 应用内广告播放时，迷你应用中正在播放的音乐会暂停。
• 遵守 Toss Ads SSP 政策。（#)
• 非测试广告的真实应用内广告会正常展示，不会中途结束或闪退。
• 不会在用户难以预料的时刻展示应用内广告。
• 应用内广告会正常展示，不会中途结束或闪退。
• 应用内广告会提前加载，不会在广告播放时实时加载。
• 应用内广告结束后，会正常回到迷你应用页面。
• 应用内广告结束后，迷你应用音乐会重新播放。
• 完整观看奖励广告后，奖励会正常发放。
• 横幅广告会显示在合适的位置。（顶部/中部/底部）
• 横幅广告仅显示在可滚动的页面中。

分享奖励

• 设置的分享奖励页面可以正常显示。
• 关闭分享奖励页面后，会正常返回迷你应用页面。
• 好友邀请完成后，奖励会正常发放。