> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/release-note/changelog-zh/release-note.md). # 发行说明 {% updates format="full" %} {% update date="2026-09-28" tags="3.6.0,sdk" %} ## 可以在服务器端交换匿名用户密钥 用于获取匿名用户密钥的一次性认证码的发放 `User.createAnonymousKeyAuthCode` API 已新增。\ 在迷你应用中获取的 `code`发送到合作方服务器进行交换后 `hash`可以获得，并且这个值与 `User.getAnonymousKey`返回的 `hash`相同。\ 代码只能使用一次 `expiresIn`（秒）内使用。 {% endupdate %} {% update date="2026-09-21" tags="3.5.0,sdk" %} ## 导航栏可在运行时更改 可在运行中更改返回·首页按钮和标题显示与否、透明背景、背景色、主题的 `NavigationBar.setOptions` API 已新增。仅会反映传入的字段，省略的字段会保留上一次应用的值，首次调用前则应用迷你应用设置中的 `navigationBar` 值。也可以在 AIT Devtools 中以 mock 形式确认此 API。 {% endupdate %} {% update date="2026-09-15" tags="3.4.1,sdk" %} ## `Promotion.openContactsInvite` 请停止使用 API 提供好友邀请（分享奖励）功能的 `Promotion.openContactsInvite`中添加了 deprecated 标记。\ API 不会立即删除，但请不要再继续使用。此 API 提供的功能今后将由其他功能替代。 {% endupdate %} {% update date="2026-09-02" tags="3.2.0,sdk" %} ## 改进游戏和本地存储 API #### 新增游戏信息叠层隐藏订阅 API 可订阅游戏信息叠层消失时机的 `Game.subscribeInfoOverlayHidden` API 已新增。 #### 新增一次读取和保存多个 Storage 值的 API 可一次性查询和保存本地存储多个值的 `Storage.getItems`, `Storage.setItems` API 已新增。 {% endupdate %} {% update date="2026-08-25" tags="3.1.1,sdk" %} ## 更改 WebView 迷你应用的服务 Origin 从 SDK 3.1.1 开始，将以与现有 SDK 2.x 相同的 Origin 提供服务。
环境变更前变更后
实际服务环境https://{appName}.web.tossmini.comhttps://{appName}.apps.tossmini.com
控制台 QR 测试环境https://{appName}.private-web.tossmini.comhttps://{appName}.private-apps.tossmini.com
[查看社区说明]() {% endupdate %} {% update date="2026-08-18" tags="3.0.4,sdk" %} ## 提升 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 自定义选项和测试还原度。 可在 bundler 配置中直接配置 mock 初始状态，也可新增、编辑 IAP 商品目录。订阅商品 mock、熄屏防止、配件按钮事件也能更贴近实际行为进行测试。 {% endupdate %} {% update date="2026-08-04" tags="3.0.2,sdk" %} ## 提供新的测试环境 新增了可在本地浏览器中直接测试迷你应用的 AIT Devtools 套件。 如果是新建项目或从 2.x 版本迁移到 3.x，系统会自动配置。 详情请参考 [SDK 3.x 迁移文档](/documentation/api-and-sdk-zh/integration/sdk-3.x.md)。 {% endupdate %} {% update date="2026-08-03" tags="3.0.1,sdk" %} ## WebView 项目结构有所改进 参数和返回值与现有 SDK 2.x 相同，因此无需单独修改代码即可应用。 * 配置文件结构变更：配置文件名称和部分属性已更改。 * 基于服务器处理：将 SDK 内部处理逻辑从客户端改为在服务器上处理。 * 稳定应对问题：即使发生 SDK 问题，也无需合作方重新发布，可在 Apps in Toss 服务器上修复并反映。 这是为了提升迷你应用生态的稳定性，并将 SDK 保持在稳定版本的更新。 详情请参考 [SDK 3.x 迁移文档](/documentation/api-and-sdk-zh/integration/sdk-3.x.md)。 {% endupdate %} {% update date="2026-07-28" tags="2.10.8,sdk" %} ## React Native 迷你应用的横幅图片规格已调整 现在会以与 WebView 迷你应用相同的规格展示横幅图片。 {% endupdate %} {% update date="2026-07-21" tags="2.10.7,sdk" %} ## 修复了在 iOS 上访问迷你应用时出现白屏的问题 在 iOS 环境下，重度使用 Toss App 的用户访问基于 WebView 的迷你应用时，曾偶尔出现白屏问题。\ 更新到最新版本后，该现象会消失。 {% endupdate %} {% update date="2026-07-13" tags="2.10.6,sdk" %} ## 修复了 WebView 闪烁问题 已解决使用底部弹窗时 WebView 偶尔闪烁的现象。 {% endupdate %} {% update date="2026-07-10" tags="2.10.5,sdk" %} ## 修复了导航栏透明模式下底部触摸问题 导航栏选项中的 `transparent` 为 true 时，修复了屏幕底部无法触摸的问题。\ 现在即使在透明模式下，也能正常触摸屏幕底部。 {% endupdate %} {% update date="2026-07-16" tags="api" %} ## Promotion、智能发送、TossPay API 支持用户识别密钥（hash）认证 此前只能通过从 Toss 登录获取的 userKey 来识别用户。\ 现在也可以使用通过用户识别密钥发放功能得到的 hash 值调用以下 API。
* **Promotion** : [通过服务器发放 Promotion 积分](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EB%B9%84%EA%B2%8C%EC%9E%84/promotion.html#%EC%84%9C%EB%B2%84%EB%A5%BC-%ED%86%B5%ED%95%B4-%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98-%ED%8F%AC%EC%9D%B8%ED%8A%B8-%EC%A7%80%EA%B8%89%ED%95%98%EA%B8%B0) * **智能发送** : [开发智能发送](https://developers-apps-in-toss.toss.im/smart-message/develop.html) * **TossPay 一次性支付** : [开发 TossPay 一次性支付](https://developers-apps-in-toss.toss.im/tosspay/develop.html) * **TossPay 定期支付** : [开发 TossPay 定期支付](https://developers-apps-in-toss.toss.im/tosspay/auto-pay.html) 还提供可确认用户识别密钥是否有效的验证 API。 {% endupdate %} {% update date="2026-07-01" tags="2.10.4,sdk" %} ## 可在导航栏隐藏图标和应用名称 `navigationBar`的 `withTitle` 选项已新增。\ `withTitle`设置为 `false`时，导航栏中的图标和应用名称会一起隐藏。\ \ 详情请参考 [导航栏](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/UI/NavigationBar.html) 文档。 {% endupdate %} {% update date="2026-06-19" tags="api" %} ## TossPay 定期支付（自动支付）功能已上线 用户首次仅需注册一次支付方式，之后即可在无需单独认证的情况下按周期自动支付。\ 通过发放 billing key 仅靠 API 调用即可进行重复支付，可用于订阅服务·定期配送·会员等多种重复计费模式。 {% endupdate %} {% update date="2026-06-19" tags="2.9.2,sdk" %} ## 在游戏应用中按下 X 按钮时会显示退出确认模态 在游戏应用中按下导航栏的 X 按钮时会显示退出确认模态。\ 非游戏应用则会直接退出，不显示退出确认模态。 {% endupdate %} {% update date="2026-06-16" tags="2.9.0,sdk" %} ## 应用包发布命令新增 --timeout 选项 `ait deploy` 命令中可用于调整发布状态确认最长等待时间的 `--timeout` 选项可用。\ 详情请参考 [测试 Toss App](https://developers-apps-in-toss.toss.im/development/test/toss.html) 文档。 {% endupdate %} {% update date="2026-06-16" tags="2.8.0,sdk" %} ## 新增非游戏导航栏主题设置功能 只需在配置文件中添加简单值，即可设置非游戏导航栏的主题。\ 支持透明模式和深色模式。\ \ 详情请参考 [导航栏](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/UI/NavigationBar.html) 文档。 {% endupdate %} {% update date="2026-06-12" tags="2.7.0,sdk" %} ## 发布用户信息功能 可在获得用户同意后，读取存储于 Toss 中的信息的 `getConsentedUserData`已新增。\ 可请求姓名、手机号、地址等最多 8 项信息。\ 无需单独服务器，仅用 SDK 即可使用。\ \ 详情请参考 [用户信息](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9C%A0%EC%A0%80%20%EC%A0%95%EB%B3%B4/getConsentedUserData.html) 文档。 {% endupdate %} {% update date="2026-06-10" tags="2.6.2,sdk" %} ## 修复 IAP 订阅支付回调 bug 在 Web 中 `IAP.createSubscriptionPurchaseOrder` 支付完成时 `processProductGrant` 回调未被调用的问题已修复。\ \ 为防范发放错误，建议同时接入 [购买恢复逻辑](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%EC%95%B1%20%EA%B2%B0%EC%A0%9C/subscription.html#purchase-recovery)。 {% endupdate %} {% update date="2026-05-27" tags="2.6.1,sdk" %} ## 移除迷你应用退出弹窗 点击导航栏 X 按钮时显示的退出确认弹窗已移除。 {% endupdate %} {% update date="2026-05-19" tags="2.6.0,sdk" %} ## 新增相册媒体选择·PDF 查看器功能 用于从用户相册选择照片·视频的 `fetchAlbumItems`以及将 PDF 数据在原生查看器中打开的 `openPDFViewer` 函数已新增。\ \ 详情请参考 [相册](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%82%AC%EC%A7%84/album.html)与 [打开 PDF 查看器](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/PDF/openPDFViewer.html) 文档。 {% endupdate %} {% update date="2026-05-12" tags="2.5.0,sdk" %} ## 新增通知同意文请求功能 在发送如补货通知、活动通知等需要事先同意的通知之前，可向用户请求接收同意 UI。\ 可通过回调接收同意结果，并决定是否发送通知。\ \ 详情请参考 [智能发送开发文档](https://developers-apps-in-toss.toss.im/smart-message/develop.html)。 #### 新增 TossPay 定期支付（自动支付）功能 用户首次仅需注册一次支付方式，之后即可在无需单独认证的情况下按周期自动支付。\ 通过发放 billing key 仅靠 API 调用即可进行重复支付，可用于订阅服务·定期配送·会员等多种重复计费模式。\ \ 详情请参考 [TossPay 定期支付开发文档](https://developers-apps-in-toss.toss.im/tosspay/auto-pay.html)。 {% endupdate %} {% update date="2026-04-09" tags="2.4.5,sdk" %} ## 新增非游戏用户识别密钥发放功能 此前只有在游戏中才能在无需服务器的情况下发放基于唯一哈希的用户识别密钥。\ 现在在非游戏中也能以相同方式发放用户识别密钥。\ 此外，原有“游戏登录”名称已更改为“用户识别密钥发放”。 {% endupdate %} {% update date="2026-04-02" tags="2.4.1,sdk" %} ## SDK 2.4.1 稳定性改进更新 已确认并修复 React 19 环境下部分 API 的运行错误。\ 已发布解决相关问题的 SDK 2.4.1。 {% endupdate %} {% update date="2026-04-01" tags="2.4.0,sdk" %} ## 新增评论请求功能 可在用户充分感受到应用价值的时刻请求评论的 `requestReview` 功能已新增。\ 合作方可通过该功能在用户体验正向的时刻自然引导评论，并提升迷你应用的价值。\ \ 详情请参考 [迷你应用评论请求](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%ED%84%B0%EB%A0%89%EC%85%98/requestReview.html) 文档。
{% endupdate %} {% update date="2026-03-30" tags="2.3.0,sdk" %} ## 补充 ait CLI 帮助并新增发布备注选项 `ait` CLI 的 `--help` 内容进行了更清晰的补充。\ 另外 `deploy` 命令执行时 `-m "发布备注"` 选项可用于一并传递发布备注。 {% endupdate %} {% update date="2026-03-30" tags="2.2.0,sdk" %} ## 新增订阅状态查询函数 现在可使用可查询订阅订单当前状态的 `getSubscriptionInfo`。\ 该功能可在 Toss App Android 5.253.0、iOS 5.253.0 以上版本使用。 {% endupdate %} {% update date="2026-03-24" tags="2.1.0,sdk" %} ## 优化字体大小及权限设置 已稳定字体大小行为并新增权限设置功能。 * 修复了根据系统字体设置，横幅广告字体大小会变化的问题。 * 修复了 Android WebView 中字体大小会随系统设置变化的问题。 * 新增可设置麦克风权限的功能。 {% endupdate %} {% update date="2026-03-18" tags="2.0.9,sdk" %} ## 提升构建与发布稳定性 已修复构建和上传过程中发生的问题。 {% endupdate %} {% update date="2026-03-18" tags="2.0.8,sdk" %} ## 优化 Promotion 发放功能 现在即使在非游戏环境中也可以无需服务器进行 Promotion 发放。\ 详情请参考 [Promotion 指南](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/growth/promotion)。 {% endupdate %} {% update date="2026-03-11" tags="2.0.5,sdk" %} ## SDK 2.0.5 稳定性改进更新 已确认并修复 SDK 2.0.4 中的额外错误。\ 已发布解决相关问题的 SDK 2.0.5。 {% endupdate %} {% update date="2026-03-10" tags="2.0.4,sdk" %} ## 改善了日志未记录的问题 已修复部分环境中日志未能正常收集的问题。 {% endupdate %} {% update date="2026-03-10" tags="1.1.1,2.0.3,sdk" %} ## 退出确认弹窗左侧按钮已改为 \[关闭] 退出确认弹窗左侧按钮的文案统一为 \[关闭]。\ \[取消] 容易让用户误以为正在执行的操作会被取消，因此不使用。\ \ 详情请参考 [通用设置中的导航栏](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/UI/Config.html#%EB%82%B4%EB%B9%84%EA%B2%8C%EC%9D%B4%EC%85%98-%EB%B0%94) 文档。
{% endupdate %} {% update date="2025-03-10" tags="1.1.0,2.0.2,sdk" %} ## SDK 2.0.2 稳定性改进更新 已确认并修复 SDK 2.0.1 中部分函数的运行问题。\ 已发布解决相关问题的 SDK 2.0.2。 {% endupdate %} {% update date="2026-03-05" tags="feature,improvement,fix,1.0.3,2.0.1,sdk" %} ## SDK 2.0.1 版本已上线 支持 React Native 0.84 和 React 19 的 SDK 2.0.1 已上线。\ 为配合 Toss App RN 0.84 更新，SDK 1.x 将不再支持。\ 3 月 23 日之后，无法再将用 1.x 构建的 bundle 上传到控制台。\ 构建命令已从 `granite build`变更为 `ait build`。 {% endupdate %} {% update date="2026-02-25" tags="api" %} ## 消息批量发送功能上线 可一次向多个用户发送相同模板消息的 **消息批量发送功能**已上线。\ 一次请求最多可发送 **2,500 条**。\ 可用于大规模活动、通知公告等需要重复发送的场景。 {% endupdate %} {% update date="2025-11-12" tags="api" %} ## Toss 一键认证功能上线 **Toss 一键认证功能**已全新上线。\ 现在用户无需输入个人信息，只需在 Toss App 中轻触一次即可轻松完成实名认证。\ \ 本功能可通过 Toss 认证 API 的 `USER_NONE` 类型接入，\ `skipConfirmDoc` 参数 `true`设置为可跳过证书确认步骤。 {% endupdate %} {% update date="2025-10-20" tags="api" %} ## Toss 认证功能上线 可将用户输入的个人信息与 Toss 注册信息进行比对， **Toss App 认证**通过此功能可确认身份。\ 现在可安全确认 CI、姓名、手机号等主要信息。 {% endupdate %} {% update date="2025-09-19" tags="api" %} ## 应用内支付订单查询状态值变更 由于新增了应用内支付商品发放流程， `PAYMENT_COMPLETED` 状态已新增。 {% endupdate %} {% update date="2025-08-05" tags="api" %} ## 应用内支付功能上线 可在应用内直接购买付费商品的 **应用内支付功能**已上线。\ 轻松销售数字商品、内容、权限等，并通过更短的购买流程快速提升收入。 {% endupdate %} {% update date="2025-04-28" tags="api" %} ## Promotion 功能上线 根据用户特定行为发放 Toss 积分的 **Promotion 功能**已上线。\ 通过 Promotion 促进转化，并提升再访·病毒传播等整个漏斗的表现。 {% endupdate %} {% update date="2025-04-25" tags="api" %} ## TossPay 功能上线 可在 Toss App 内快速且安全地支付的 **TossPay 功能**已上线。\ 请便捷完成实物商品·服务支付。 {% endupdate %} {% update date="2025-04-18" tags="api" %} ## Toss 登录功能上线 可使用 Toss 账户便捷登录的 **Toss 登录功能**已上线。\ 只需一次同意即可将注册、登录、信息提供一并连接。 {% endupdate %} {% update date="2025-04-15" tags="api" %} ## 功能性推送功能上线 可在关键时刻重新召回用户的 **功能性推送、通知功能**已上线。\ 请积极利用，以提升留存并促进转化。 {% endupdate %} {% endupdates %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://developers-apps-in-toss.toss.im/release-note/changelog-zh/release-note.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.