> 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/en/release-note.md). # Release Notes {% updates format="full" %} {% update date="2026-09-28" tags="3.6.0,sdk" %} ## You can exchange anonymous user keys on the server Issue a one-time authentication code to receive an anonymous user key `User.createAnonymousKeyAuthCode` API has been added. \ The `code`sent from the mini app to the partner company's server and exchanged, `hash`can be obtained, and this value is the same as `User.getAnonymousKey`returned by `hash`is the same as. \ The code can only be used once and `expiresIn`must be used within (seconds). {% endupdate %} {% update date="2026-09-21" tags="3.5.0,sdk" %} ## You can change the navigation bar at runtime You can change whether the back/home buttons and title are shown, transparent background, background color, and theme while running `NavigationBar.setOptions` API has been added. Only the fields you pass are applied, omitted fields keep the previously applied values, and before the first call, the mini app setting's `navigationBar` value is applied. You can also verify this API as a mock in AIT Devtools. {% endupdate %} {% update date="2026-09-15" tags="3.4.1,sdk" %} ## `Promotion.openContactsInvite` Please stop using the API that provided the friend invitation (sharing reward) feature `Promotion.openContactsInvite`has been marked deprecated.\ The API will not be removed immediately, but please no longer use it. The functionality provided by this API will be replaced by another feature in the future. {% endupdate %} {% update date="2026-09-02" tags="3.2.0,sdk" %} ## Improve game and local storage APIs #### Add API to subscribe to hiding the game info overlay An API has been added that lets you subscribe to the timing when the game info overlay disappears `Game.subscribeInfoOverlayHidden` API has been added. #### Add API to read and save multiple Storage values at once An API has been added that lets you query and save multiple local storage values at once `Storage.getItems`, `Storage.setItems` API has been added. {% endupdate %} {% update date="2026-08-25" tags="3.1.1,sdk" %} ## Change the service origin of WebView mini apps From SDK 3.1.1, they are served from the same origin as the existing SDK 2.x.
EnvironmentBefore changeAfter change
Production environmenthttps://{appName}.web.tossmini.comhttps://{appName}.apps.tossmini.com
Console QR test environmenthttps://{appName}.private-web.tossmini.comhttps://{appName}.private-apps.tossmini.com
[Go to the community notice]() {% endupdate %} {% update date="2026-08-18" tags="3.0.4,sdk" %} ## Improve web-framework stability and development experience In this release, we made the default behavior of mini apps more stable and improved the development experience of CLI and Devtools. * `webView.pullToRefreshEnabled`default value of `false`has been changed to. This change is to prevent unintended refreshes while scrolling, and if needed `apps-in-toss.config.ts` in `defineConfig`set it directly to `true`in. * The ait --help content has been thoroughly improved. Examples are organized around the actual bin name ait, and Korean/English output, color detection, ait --version, and main command descriptions have been added. * When building `appName`, `brand`, `webBundle` so that the settings are validated. `brand.primaryColor` default value has also been added. * We've improved mock customization options and test fidelity in AIT Devtools. You can configure the mock initial state directly in the bundler settings, and add or edit the IAP product catalog. Subscription product mocks, preventing the screen from turning off, and accessory button events can also be tested more close to actual behavior. {% endupdate %} {% update date="2026-08-04" tags="3.0.2,sdk" %} ## Provide a new test environment The AIT Devtools package has been added, allowing you to test mini apps directly in your local browser. If you scaffold a new project or migrate from version 2.x to 3.x, it is set automatically. For details, [SDK 3.x migration guide](/documentation/api-and-sdk-en/integration/sdk-3.x.md)please refer to. {% endupdate %} {% update date="2026-08-03" tags="3.0.1,sdk" %} ## The structure of WebView projects has been improved The parameters and return values are the same as the existing SDK 2.x, so it can be applied without separate code changes. * Configuration file structure change: the configuration file name and some properties have changed. * Server-based processing: We changed SDK internal processing so it runs on the server instead of the client. * Stable issue response: Even if an SDK issue occurs, you can fix and apply it on the Apps in Toss server without redeploying from the partner. This update increases the stability of the mini app ecosystem and keeps the SDK on a stable version. For details, [SDK 3.x migration guide](/documentation/api-and-sdk-en/integration/sdk-3.x.md)please refer to. {% endupdate %} {% update date="2026-07-28" tags="2.10.8,sdk" %} ## The banner image specifications for React Native mini apps have been updated Banner images are now displayed with the same specifications as WebView mini apps. {% endupdate %} {% update date="2026-07-21" tags="2.10.7,sdk" %} ## Fixed an issue where a white screen appeared when accessing mini apps on iOS Heavy users who use the Toss app a lot had an issue where a white screen intermittently appeared when accessing WebView-based mini apps in the iOS environment.\ Updating to the latest version removes this symptom. {% endupdate %} {% update date="2026-07-13" tags="2.10.6,sdk" %} ## Fixed the WebView flickering issue We resolved an issue where the WebView intermittently flickered when using a bottom sheet. {% endupdate %} {% update date="2026-07-10" tags="2.10.5,sdk" %} ## Fixed bottom touch issue in transparent navigation bar mode In the navigation bar option `transparent` when was true, the bottom of the screen could not be touched.\ Now you can touch the bottom of the screen normally even in transparent mode. {% endupdate %} {% update date="2026-07-16" tags="api" %} ## Support user identifier key (hash) authentication in Promotion, Smart Dispatch, and Toss Pay APIs Previously, users could only be identified with the userKey issued through Toss Login.\ Now, you can also call the APIs below with the hash value received through the user identification key issuance feature.
* **Promotion** : [Grant promotion points through the server](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) * **Smart Dispatch** : [Develop Smart Dispatch](https://developers-apps-in-toss.toss.im/smart-message/develop.html) * **Toss Pay one-time payment** : [Develop Toss Pay one-time payment](https://developers-apps-in-toss.toss.im/tosspay/develop.html) * **Toss Pay recurring payment** : [Develop Toss Pay recurring payment](https://developers-apps-in-toss.toss.im/tosspay/auto-pay.html) A validation API is also provided to check whether the user identification key is valid. {% endupdate %} {% update date="2026-07-01" tags="2.10.4,sdk" %} ## You can hide the icon and app name in the navigation bar `navigationBar`in `withTitle` option has been added.\ `withTitle`If you set `false`to [navigation bar](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/UI/NavigationBar.html) please refer to the documentation. {% endupdate %} {% update date="2026-06-19" tags="api" %} ## Toss Pay recurring payment (automatic payment) has been released Once a user registers a payment method for the first time, they can make recurring automatic payments thereafter without separate authentication.\ By issuing a billing key and processing repeated payments through API calls alone, it can be used for various recurring billing models such as subscription services, regular deliveries, and memberships. {% endupdate %} {% update date="2026-06-19" tags="2.9.2,sdk" %} ## When you press the X button in a game app, a confirmation modal appears When you press the X button in the navigation bar in a game app, a confirmation modal is displayed.\ Non-game apps close immediately without a confirmation modal. {% endupdate %} {% update date="2026-06-16" tags="2.9.0,sdk" %} ## The --timeout option has been added to the app bundle deployment command `ait deploy` In the command, you can use the `--timeout` option, which controls the maximum wait time for checking deployment status.\ For details, [Test the Toss app](https://developers-apps-in-toss.toss.im/development/test/toss.html) please refer to the documentation. {% endupdate %} {% update date="2026-06-16" tags="2.8.0,sdk" %} ## A theme-setting feature for the non-game navigation bar has been added You can set the theme of the non-game navigation bar by adding simple values to the configuration file.\ Transparent mode and dark mode are supported.\ \ For details, [navigation bar](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/UI/NavigationBar.html) please refer to the documentation. {% endupdate %} {% update date="2026-06-12" tags="2.7.0,sdk" %} ## The user info feature has been released Get information stored in Toss with user consent `getConsentedUserData`has been added.\ You can request up to 8 items, including name, mobile phone number, and address.\ It can be used with SDK only, without a separate server.\ \ For details, [User info](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) please refer to the documentation. {% endupdate %} {% update date="2026-06-10" tags="2.6.2,sdk" %} ## Fixed IAP subscription payment callback bug On the web, `IAP.createSubscriptionPurchaseOrder` when payment is completed, `processProductGrant` we fixed an issue where the callback was not called.\ \ To prepare for grant errors, [purchase recovery logic](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)is also recommended. {% endupdate %} {% update date="2026-05-27" tags="2.6.1,sdk" %} ## Removed mini app exit modal The exit confirmation modal that appeared when pressing the X button in the navigation bar has been removed. {% endupdate %} {% update date="2026-05-19" tags="2.6.0,sdk" %} ## Added album media selection ยท PDF viewer feature Select photos and videos from the user's album `fetchAlbumItems`and open PDF data in the native viewer `openPDFViewer` functions have been added.\ \ For details, [Album](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%82%AC%EC%A7%84/album.html)and [Open PDF viewer](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/PDF/openPDFViewer.html) please refer to the documentation. {% endupdate %} {% update date="2026-05-12" tags="2.5.0,sdk" %} ## Added notification consent request feature Before sending notifications that require prior consent, such as restock alerts or event alerts, you can request a consent UI from the user.\ You can receive the consent result through a callback and decide whether to send the notification.\ \ For details, [Smart Dispatch development guide](https://developers-apps-in-toss.toss.im/smart-message/develop.html)please refer to. #### Added Toss Pay recurring payment (automatic payment) feature Once a user registers a payment method for the first time, they can make recurring automatic payments thereafter without separate authentication.\ By issuing a billing key and processing repeated payments through API calls alone, it can be used for various recurring billing models such as subscription services, regular deliveries, and memberships.\ \ For details, [Toss Pay recurring payment development guide](https://developers-apps-in-toss.toss.im/tosspay/auto-pay.html)please refer to. {% endupdate %} {% update date="2026-04-09" tags="2.4.5,sdk" %} ## Added non-game user identification key issuance feature Previously, only games could issue a unique hash-based user identification key without a server.\ Now, non-games can also issue a user identification key in the same way.\ Also, the existing 'game login' name has been changed to 'user identification key issuance'. {% endupdate %} {% update date="2026-04-02" tags="2.4.1,sdk" %} ## SDK 2.4.1 stability improvement update We found and fixed some API behavior errors in the React 19 environment.\ We released SDK 2.4.1 with the related issues resolved. {% endupdate %} {% update date="2026-04-01" tags="2.4.0,sdk" %} ## Review request feature has been added An `requestReview` feature has been added that lets you request a review when the user has sufficiently felt the app's value.\ Through this feature, partners can naturally encourage reviews at positive moments in the user experience and increase the value of the mini app.\ \ For details, [Mini app review request](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/%EC%9D%B8%ED%84%B0%EB%A0%89%EC%85%98/requestReview.html) please refer to the documentation.
{% endupdate %} {% update date="2026-03-30" tags="2.3.0,sdk" %} ## Enhanced ait CLI help and added release memo option `ait` CLI `--help` help content has been clarified further.\ Also, `deploy` when running the command `-m "release memo"` option to pass the release memo along. {% endupdate %} {% update date="2026-03-30" tags="2.2.0,sdk" %} ## Added subscription status lookup function Now you can use `getSubscriptionInfo`to check the current status of a subscription order.\ This feature is available on Toss app Android 5.253.0 and iOS 5.253.0 or later. {% endupdate %} {% update date="2026-03-24" tags="2.1.0,sdk" %} ## Improved font size and permission settings We've stabilized font size behavior and added permission settings. * Fixed an issue where the font size of banner ads changed depending on the system font setting. * Fixed an issue where the font size changed according to system settings in Android WebView. * Added a feature to set microphone permissions. {% endupdate %} {% update date="2026-03-18" tags="2.0.9,sdk" %} ## Improved build and deployment stability Fixed issues occurring during the build and upload process. {% endupdate %} {% update date="2026-03-18" tags="2.0.8,sdk" %} ## Improved promotion grant feature Now promotion grants are possible without a server even in non-game environments.\ For details, [Promotion guide](https://appsintoss.gitbook.io/appsintoss-docs/documentation/common/growth/promotion)please refer to. {% endupdate %} {% update date="2026-03-11" tags="2.0.5,sdk" %} ## SDK 2.0.5 stability improvement update Additional errors were found in SDK 2.0.4 and fixed.\ We released SDK 2.0.5 with the related issues resolved. {% endupdate %} {% update date="2026-03-10" tags="2.0.4,sdk" %} ## Improved an issue where logging did not work Fixed an issue where logs were not collected properly in some environments. {% endupdate %} {% update date="2026-03-10" tags="1.1.1,2.0.3,sdk" %} ## The left button in the exit confirmation modal has been changed to \[Close] The left button in the exit confirmation modal is standardized to \[Close].\ \[Cancel] is not used because it could be misunderstood as canceling the task the user is currently doing.\ \ For details, [navigation bar in common settings](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) please refer to the documentation.
{% endupdate %} {% update date="2025-03-10" tags="1.1.0,2.0.2,sdk" %} ## SDK 2.0.2 stability improvement update Some function behavior issues were found in SDK 2.0.1 and fixed.\ We released SDK 2.0.2 with the related issues resolved. {% endupdate %} {% update date="2026-03-05" tags="feature,improvement,fix,1.0.3,2.0.1,sdk" %} ## SDK 2.0.1 has been released SDK 2.0.1, which supports React Native 0.84 and React 19, has been released.\ In line with the Toss app RN 0.84 update, SDK 1.x is no longer supported.\ After March 23, bundles built with 1.x cannot be uploaded to the console.\ The build command has been changed from `granite build`to `ait build`. {% endupdate %} {% update date="2026-02-25" tags="api" %} ## Mass message sending feature launched Mass message sending feature **is released**has been launched.\ You can send to up to **2,500**items in a single request.\ Use it efficiently when you need repeated sending for mass campaigns or announcements. {% endupdate %} {% update date="2025-11-12" tags="api" %} ## Toss one-touch authentication feature launched **Toss one-touch authentication feature**has been newly launched.\ Now users can easily complete identity verification in the Toss app with a single touch, without entering personal information.\ \ This feature can be integrated with the Toss authentication API as `USER_NONE` type, and\ `skipConfirmDoc` parameter `true`can be set to skip the certificate confirmation step. {% endupdate %} {% update date="2025-10-20" tags="api" %} ## Toss authentication feature launched The feature has been released to compare the personal information entered by the user with Toss sign-up information, and **Toss app authentication**to verify identity.\ Now you can safely verify key information such as CI, name, and mobile phone number. {% endupdate %} {% update date="2025-09-19" tags="api" %} ## In-app payment order lookup status value changed The in-app payment product grant process has been added, so `PAYMENT_COMPLETED` status has been added. {% endupdate %} {% update date="2025-08-05" tags="api" %} ## In-app payment feature launched An **in-app payment feature**has been launched.\ Easily sell digital products, content, permissions, and more, and increase revenue quickly with a short purchase flow. {% endupdate %} {% update date="2025-04-28" tags="api" %} ## Promotion feature launched A **promotion feature**has been launched.\ Use promotions to drive conversions and improve funnel performance throughout re-visits and viral spread. {% endupdate %} {% update date="2025-04-25" tags="api" %} ## Toss Pay feature launched A **Toss Pay feature**has been launched.\ Easily process payments for physical goods and services. {% endupdate %} {% update date="2025-04-18" tags="api" %} ## Toss Login feature launched A **Toss Login feature**has been launched.\ With a single consent, you can connect sign-up, login, and data provision all at once. {% endupdate %} {% update date="2025-04-15" tags="api" %} ## Functional push feature launched A **functional push and notification feature**has been launched.\ Use it actively to improve retention and drive conversions. {% 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/en/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.