发布说明

2026年9月2日

改进游戏和本地存储 API

新增游戏信息浮层隐藏订阅 API

可订阅游戏信息浮层消失时机的 Game.subscribeInfoOverlayHidden API 已新增。

新增可一次读取并保存多个 Storage 值的 API

可一次查询并保存本地存储的多个值的 Storage.getItems, Storage.setItems API 已新增。

2026年8月25日

更改 WebView 迷你应用的服务 Origin

从 SDK 3.1.1 起，将以与既有 SDK 2.x 相同的 Origin 提供服务。

环境	更改前	更改后
实际服务环境	https://{appName}.web.tossmini.com	https://{appName}.apps.tossmini.com
控制台 QR 测试环境	https://{appName}.private-web.tossmini.com	https://{appName}.private-apps.tossmini.com

查看社区公告

2026年8月18日

改进 web-framework 的稳定性和开发体验

本次发布中，我们更稳定地调整了迷你应用的基础行为，并改善了 CLI 和 Devtools 的开发体验。

• webView.pullToRefreshEnabled的默认值 false改为 false。此变更旨在防止滚动时意外刷新，如有需要， apps-in-toss.config.ts 中的 defineConfig里直接 true设置即可。
• 全面优化了 ait --help。我们以实际的 bin 名称 ait 为准整理了示例，并补充了韩文/英文输出、颜色检测、ait --version、主要命令说明。
• 构建时 appName, brand, webBundle 配置进行验证。 brand.primaryColor 的默认值也已新增。
• 改进了 AIT Devtools 的 mock 自定义选项和测试真实性。

  可以在打包器设置中直接配置 mock 初始状态，还可以添加·编辑 IAP 商品目录。订阅商品 mock、屏幕常亮防止、配件按钮事件也能更接近真实行为地测试。

2026年8月4日

提供新的测试环境

新增了可在本地浏览器中直接测试迷你应用的 AIT Devtools 包。

在新项目脚手架生成或从 2.x 版本迁移到 3.x 时会自动设置。

详细内容请看 SDK 3.x 迁移文档。请参考。

2026年8月3日

WebView 项目结构已改进

参数和返回值与现有 SDK 2.x 相同，因此无需单独修改代码即可应用。

• 配置文件结构变更：配置文件名称和部分属性已更改。
• 基于服务器的处理：已更改为由服务器而非客户端处理 SDK 内部逻辑。
• 稳定的问题应对：即使发生 SDK 问题，也可以无需合作方重新发布，直接在 Apps in Toss 服务器上修复并反映。

这是为了提升迷你应用生态的稳定性并将 SDK 保持在稳定版本的更新。

详细内容请看 SDK 3.x 迁移文档。请参考。

2026年7月28日

React Native 迷你应用的横幅图片规格已修改

现在横幅图片将以与 WebView 迷你应用相同的规格展示。

2026年7月21日

已修复在 iOS 上访问迷你应用时出现白屏的问题

重度使用 Toss 应用的用户在 iOS 环境下访问基于 WebView 的迷你应用时，曾偶尔出现白屏问题。 更新到最新版本后，该现象会消失。

2026年7月13日

已修复 WebView 闪烁问题

已解决使用底部弹窗时 WebView 偶尔闪烁的现象。

2026年7月10日

已修复导航栏透明模式下底部触控问题

导航栏选项的 transparent 为 true 时无法触碰屏幕底部的问题已修复。 现在即使在透明模式下，也能正常触碰屏幕底部。

2026年7月16日

在促销、智能发送、Toss Pay API 中支持用户识别键(hash)认证

以往只能使用通过 Toss 登录发放的 userKey 来识别用户。 现在也可以用通过用户识别键发放功能获取的 hash 值调用以下 API。

• 促销 : 通过服务器发放促销积分
• 智能发送 : 开发智能发送
• Toss Pay 一次性支付 : 开发 Toss Pay 一次性支付
• Toss Pay 定期支付 : 开发 Toss Pay 定期支付

还提供可确认用户识别键是否有效的验证 API。

2026年7月1日

可以在导航栏中隐藏图标和应用名称

navigationBar中 withTitle 新增了选项。 withTitle将其 false设置为后，导航栏中的图标和应用名称会一起隐藏。 详情请见 导航栏 文档。

2026年6月19日

Toss Pay 定期支付（自动扣款）功能已推出

如果用户首次注册一次支付方式，之后无需单独认证即可周期性自动扣款。 通过发行 billing key 并仅通过 API 调用来进行重复支付的方式，可用于订阅服务·定期配送·会员等各种重复收费模型。

2026年6月19日

在游戏应用中按下 X 按钮会弹出退出确认弹窗

在游戏应用中按下导航栏的 X 按钮时，会显示退出确认弹窗。 非游戏应用会直接退出，不显示退出确认弹窗。

2026年6月16日

应用包分发命令新增了 --timeout 选项

ait deploy 用于调整命令中部署状态确认的最长等待时间的 --timeout 选项可用。 详情请见 测试 Toss 应用 文档。

2026年6月16日

新增非游戏导航栏主题设置功能

只需在配置文件中添加几个简单的值，就能设置非游戏导航栏的主题。 支持透明模式和深色模式。 详情请见 导航栏 文档。

2026年6月12日

用户信息功能已上线

在取得用户同意后，读取存储在 Toss 中的信息的 getConsentedUserData已新增。 可请求姓名、手机号码、地址等最多 8 项。 无需单独服务器，仅凭 SDK 即可使用。 详情请见 用户信息 文档。

2026年6月10日

修复 IAP 订阅支付回调 bug

在网页端 IAP.createSubscriptionPurchaseOrder 支付完成时 processProductGrant 已修复回调未被调用的问题。 为防止发放错误， 购买恢复逻辑也建议一并接入。

2026年5月27日

移除迷你应用退出弹窗

移除在按下导航栏 X 按钮时显示的退出确认弹窗。

2026年5月19日

新增相册媒体选择 · PDF 查看器功能

从用户相册中选择照片·视频的 fetchAlbumItems以及将 PDF 数据在原生查看器中打开的 openPDFViewer 函数已新增。 详情请见 相册和 打开 PDF 查看器 文档。

2026年5月12日

新增通知同意文案请求功能

在发送补货通知、活动通知等需要事先同意的通知之前，可向用户请求接收同意 UI。 可通过回调接收同意结果，并决定是否发送通知。 详情请见 智能发送开发文档请参考。

新增 Toss Pay 定期支付（自动扣款）功能

如果用户首次注册一次支付方式，之后无需单独认证即可周期性自动扣款。 通过发行 billing key 并仅通过 API 调用来进行重复支付的方式，可用于订阅服务·定期配送·会员等各种重复收费模型。 详情请见 Toss Pay 定期支付开发文档请参考。

2026年4月9日

新增非游戏用户识别键发放功能

以往只有游戏中才能在无需服务器的情况下发放基于哈希的唯一用户识别键。 现在非游戏也可以用相同方式发放用户识别键。 另外，原有的“游戏登录”名称已更改为“用户识别键发放”。

2026年4月2日

SDK 2.4.1 稳定性改进更新

已确认并修复在 React 19 环境下部分 API 的运行错误。 已发布解决相关问题的 SDK 2.4.1。

2026年4月1日

新增评价请求功能

可在用户充分感受到应用价值的时机请求评价的 requestReview 功能已新增。 合作方可通过该功能在用户体验积极的瞬间自然引导评价，并提升迷你应用的价值。 详情请见 迷你应用评价请求 文档。

2026年3月30日

加强 ait CLI 帮助并新增发布备注选项

ait CLI 的 --help 内容已进一步清晰补充。 此外 deploy 执行命令时 -m "发布备注" 可以通过该选项一并传递发布备注。

2026年3月30日

新增订阅状态查询函数

现在可查询订阅订单当前状态的 getSubscriptionInfo可使用。 该功能可在 Toss 应用 Android 5.253.0、iOS 5.253.0 及以上版本使用。

2026年3月24日

改进字体大小及权限设置

已稳定字体大小行为并新增权限设置功能。

• 已修复根据系统字体设置导致横幅广告字体大小变化的问题。
• 已修复 Android WebView 中字体大小会随系统设置变化的问题。
• 新增可设置麦克风权限的功能。

2026年3月18日

改进构建及分发稳定性

已修复在构建及上传过程中发生的问题。

2026年3月18日

改进促销发放功能

现在在非游戏环境下也可以无需服务器发放促销。 详情请见 促销指南。请参考。

2026年3月11日

SDK 2.0.5 稳定性改进更新

已确认并修复 SDK 2.0.4 中的附加错误。 已发布解决相关问题的 SDK 2.0.5。

2026年3月10日

改进了无法进行日志记录的问题

已修复在部分环境中日志无法正常收集的问题。

2026年3月10日

退出确认弹窗的左侧按钮已改为 [关闭]

退出确认弹窗左侧按钮的文案统一为 [关闭]。 因为 [取消] 可能会让用户误以为正在进行的操作会被取消，所以不使用。 详情请见 通用设置中的导航栏 文档。

2025年3月10日

SDK 2.0.2 稳定性改进更新

已确认并修复 SDK 2.0.1 中部分函数行为问题。 已发布解决相关问题的 SDK 2.0.2。

2026年3月5日

SDK 2.0.1 版本已发布

支持 React Native 0.84 和 React 19 的 SDK 2.0.1 已发布。 配合 Toss 应用 RN 0.84 更新，SDK 1.x 将不再支持。 3 月 23 日之后，无法将使用 1.x 构建的 bundle 上传到控制台。 构建命令已从 granite build变更为 ait build。

2026年2月25日

消息批量发送功能上线

可向多个用户一次性发送相同模板消息的 消息批量发送功能已上线。 一次请求最多可发送 2,500 条。 如大规模活动、通知公告等需要重复发送的场景，可高效使用。

2025年11月12日

Toss 一触认证功能上线

Toss 一触认证功能已全新上线。 现在用户无需输入个人信息，即可在 Toss 应用中通过一次触控轻松完成实名认证。 本功能可通过 Toss 认证 API 的 USER_NONE 类型接入，并且 skipConfirmDoc 参数 true设置为后，可以跳过证书确认步骤。

2025年10月20日

Toss 认证功能上线

将用户输入的个人信息与 Toss 注册信息进行比对， Toss 应用认证已推出可通过其确认身份的功能。 现在可以安全确认 CI、姓名、手机号码等主要信息。

2025年9月19日

应用内支付订单查询状态值变更

由于新增了应用内支付商品发放流程， PAYMENT_COMPLETED 新增了该状态。

2025年8月5日

应用内支付功能上线

可在应用内直接购买付费商品的 应用内支付功能已上线。 可轻松销售数字商品、内容、权限等，并通过简短的购买流程快速提升营收。

2025年4月28日

促销功能上线

根据用户的特定行为发放 Toss 积分的 促销功能已上线。 通过促销引导转化，并提升复访·病毒传播等整个漏斗的表现。

2025年4月25日

Toss Pay 功能上线

可在 Toss 应用内快速安全支付的 Toss Pay 功能已上线。 请便捷地进行实物商品·服务支付。

2025年4月18日

Toss 登录功能上线

可用 Toss 账号便捷登录的 Toss 登录功能已上线。 只需一次同意，即可一并串联注册、登录、信息提供。

2025年4月15日

功能性推送功能上线

可在关键时刻重新召回用户的 功能性推送、通知功能已上线。 请积极用于提升留存和引导转化。