> 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-21" tags="3.5.0,sdk" %} ## You can change the navigation bar at runtime Whether the back and home buttons and title are shown, transparent background, background color, and theme can be changed while running `NavigationBar.setOptions` The API has been added. Only the fields you pass in 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 check 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 (share reward) feature `Promotion.openContactsInvite`has been marked as 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" %} ## We’re improving the game and local storage APIs #### Added subscription API for hiding the game info overlay that lets you subscribe to when the game info overlay disappears `Game.subscribeInfoOverlayHidden` API has been added. #### Added API to read and save multiple Storage values at once 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" %} ## We're changing the service origin of WebView mini apps Starting with SDK 3.1.1, it is served with 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
[View the community announcement]() {% endupdate %} {% update date="2026-08-18" tags="3.0.4,sdk" %} ## We're improving web-framework stability and the development experience In this release, we've made the mini app's default behavior more stable and improved the development experience in CLI and Devtools. * `webView.pullToRefreshEnabled`default value `false`to prevent unintended refreshes while scrolling. If needed, `apps-in-toss.config.ts` of `defineConfig`you can set it directly `true`Please set it. * We overhauled ait --help. We organized examples around the actual bin name, ait, and expanded Korean/English output, color detection, ait --version, and major command descriptions. * At build time `appName`, `brand`, `webBundle` to validate the settings. `brand.primaryColor` We also added a default value. * We've improved the 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 IAP product catalogs. You can also test subscription product mocks, screen sleep prevention, and accessory button events in a way that's closer to real behavior. {% endupdate %} {% update date="2026-08-04" tags="3.0.2,sdk" %} ## We provide a new test environment The AIT Devtools package has been added, letting you test mini apps directly in your local browser. It is set up automatically when you scaffold a new project or migrate from version 2.x to 3.x. For more 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 in the existing SDK 2.x, so you can apply them without changing any code. * Configuration file structure changes: the configuration file name and some properties have changed. * Server-based processing: the SDK's internal processing logic has been changed to run on the server instead of the client. * Stable issue response: even if an SDK issue occurs, it can be fixed and reflected from the Apps in Toss server without the partner company redeploying. This update is to increase the stability of the mini app ecosystem and keep the SDK on a stable version. For more 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 specs for React Native mini apps have been changed Banner images are now displayed using the same specs as WebView mini apps. {% endupdate %} {% update date="2026-07-21" tags="2.10.7,sdk" %} ## We fixed an issue where a white screen appeared when accessing mini apps on iOS Heavy users who use the Toss app a lot sometimes saw a white screen when accessing WebView-based mini apps in the iOS environment.\ Updating to the latest version will eliminate this symptom. {% endupdate %} {% update date="2026-07-13" tags="2.10.6,sdk" %} ## We fixed the WebView flickering issue We resolved an issue where the WebView would intermittently flicker when using a bottom sheet. {% endupdate %} {% update date="2026-07-10" tags="2.10.5,sdk" %} ## We fixed the bottom touch issue in transparent navigation bar mode in the navigation bar option `transparent` When this was true, touches at the bottom of the screen did not work.\ Now you can touch the bottom of the screen normally even in transparent mode. {% endupdate %} {% update date="2026-07-16" tags="api" %} ## We support user identifier key (hash) authentication in Promotion, Smart Send, 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 issued by the user identifier 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 Send** : [Develop Smart Send](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 verification API is also provided so you can check whether the user identifier 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`to `false`If set to, the icon and app name will both be hidden in the navigation bar.\ \ For more details, see the [navigation bar](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/UI/NavigationBar.html) documentation. {% endupdate %} {% update date="2026-06-19" tags="api" %} ## Toss Pay recurring payment (automatic payment) has been launched If a user registers a payment method once, they can then make recurring automatic payments without additional authentication.\ This works by issuing a billing key and making repeated payments through API calls alone, and 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 quit confirmation modal is shown.\ Non-game apps exit immediately without a quit 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` that adjusts the maximum wait time for checking deployment status in the command `--timeout` option.\ For more details, see [Test the Toss app](https://developers-apps-in-toss.toss.im/development/test/toss.html) documentation. {% endupdate %} {% update date="2026-06-16" tags="2.8.0,sdk" %} ## A theme configuration feature for the non-game navigation bar has been added You can set the theme of the non-game navigation bar by adding just a simple value to the configuration file.\ It supports transparent mode and dark mode.\ \ For more details, see [navigation bar](https://developers-apps-in-toss.toss.im/bedrock/reference/framework/UI/NavigationBar.html) documentation. {% endupdate %} {% update date="2026-06-12" tags="2.7.0,sdk" %} ## We launched the user information feature that retrieves information stored in Toss with the user's consent `getConsentedUserData`has been added.\ You can request up to 8 items, including name, mobile phone number, and address.\ You can use it with just the SDK, without a separate server.\ \ For more details, see [User information](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) documentation. {% endupdate %} {% update date="2026-06-10" tags="2.6.2,sdk" %} ## Fixed a bug in the IAP subscription payment callback On the web `IAP.createSubscriptionPurchaseOrder` when payment is completed `processProductGrant` We fixed an issue where the callback was not called.\ \ We recommend also integrating the [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)to prepare for grant errors. {% endupdate %} {% update date="2026-05-27" tags="2.6.1,sdk" %} ## Removed the 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 and PDF viewer features that selects photos and videos from the user's album `fetchAlbumItems`and open PDF data in the native viewer `openPDFViewer` functions have been added.\ \ For more details, see [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) 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 notifications or event notifications, 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 more details, see [Smart Send development guide](https://developers-apps-in-toss.toss.im/smart-message/develop.html)please refer to #### Toss Pay recurring payment (automatic payment) feature added If a user registers a payment method once, they can then make recurring automatic payments without additional authentication.\ This works by issuing a billing key and making repeated payments through API calls alone, and it can be used for various recurring billing models such as subscription services, regular deliveries, and memberships.\ \ For more details, see [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 identifier key issuance feature Previously, only games could issue a unique hash-based user identifier key without a server.\ Now non-game apps can issue a user identifier key the same way.\ Also, the existing 'game login' name has been changed to 'user identifier key issuance'. {% endupdate %} {% update date="2026-04-02" tags="2.4.1,sdk" %} ## SDK 2.4.1 stability improvement update We found and fixed an API behavior error in the React 19 environment.\ We released SDK 2.4.1 with the related issue resolved. {% endupdate %} {% update date="2026-04-01" tags="2.4.0,sdk" %} ## Added review request feature that can request a review when users have fully felt the app's value `requestReview` feature has been added.\ Through this feature, partners can naturally prompt for reviews at moments of positive user experience and increase the value of the mini app.\ \ For more details, see [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) documentation.
{% endupdate %} {% update date="2026-03-30" tags="2.3.0,sdk" %} ## Enhanced ait CLI help and added release note option `ait` CLI `--help` content more clearly.\ Also `deploy` when running the command `-m "release note"` you can pass the release note together through the option. {% endupdate %} {% update date="2026-03-30" tags="2.2.0,sdk" %} ## Added subscription status lookup function You can now use `getSubscriptionInfo`to look up the current status of a subscription order.\ This feature is available in 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 stabilized font size behavior and added permission settings. * We fixed an issue where banner ad font size changed depending on the system font setting. * We fixed an issue where font size changed according to system settings in Android WebView. * We added a feature to set microphone permissions. {% endupdate %} {% update date="2026-03-18" tags="2.0.9,sdk" %} ## Improved build and deployment stability We fixed issues that occurred during the build and upload process. {% endupdate %} {% update date="2026-03-18" tags="2.0.8,sdk" %} ## Improved promotion payout feature Promotion payouts are now possible even in non-game environments without a server.\ For more details, see [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 We found additional errors in SDK 2.0.4 and fixed them.\ We released SDK 2.0.5 with the related issue resolved. {% endupdate %} {% update date="2026-03-10" tags="2.0.4,sdk" %} ## Improved the issue where logging was not working We fixed an issue where logs were not being 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] We are standardizing the left button in the exit confirmation modal to \[Close].\ We do not use \[Cancel] because it can be misunderstood as canceling the task the user is doing.\ \ For more details, see [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) documentation.
{% endupdate %} {% update date="2025-03-10" tags="1.1.0,2.0.2,sdk" %} ## SDK 2.0.2 stability improvement update We found and fixed some function behavior issues in SDK 2.0.1.\ We released SDK 2.0.2 with the related issue 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's RN 0.84 update, SDK 1.x is no longer supported.\ After March 23, bundles built with 1.x can no longer 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" %} ## Launched mass message sending feature A **mass message sending feature**that can send the same template message to multiple users at once has been launched.\ With a single request, you can send up to **2,500**messages.\ Use it efficiently for situations that require repeated sending, such as large-scale campaigns and announcements. {% endupdate %} {% update date="2025-11-12" tags="api" %} ## Launched Toss one-touch authentication feature **Toss one-touch authentication feature**has been launched.\ Now users can complete identity verification easily with a single tap in the Toss app without entering personal information.\ \ This feature can be integrated with the Toss authentication API using the `USER_NONE` type, and\ `skipConfirmDoc` parameter `true`can be set to skip the certificate confirmation step. {% endupdate %} {% update date="2025-10-20" tags="api" %} ## Launched Toss authentication feature It compares the personal information entered by the user with Toss sign-up information, and **Toss app authentication**a feature has been launched that can verify identity through.\ Now you can securely verify key information such as CI, name, and mobile phone number. {% endupdate %} {% update date="2025-09-19" tags="api" %} ## Changed in-app payment order lookup status values Since an additional in-app payment product grant process has been added, `PAYMENT_COMPLETED` status has been added. {% endupdate %} {% update date="2025-08-05" tags="api" %} ## Launched in-app payment feature that lets you directly purchase paid products inside the app **in-app payment feature**has been launched.\ Easily sell digital products, content, and permissions, and quickly grow revenue with a short purchase flow. {% endupdate %} {% update date="2025-04-28" tags="api" %} ## Launched promotion feature that gives Toss points based on specific user actions **promotion feature**has been launched.\ Use promotions to drive conversions and improve performance across the entire funnel, including revisit and virality. {% endupdate %} {% update date="2025-04-25" tags="api" %} ## Launched Toss Pay feature that allows fast and secure payments within the Toss app **Toss Pay feature**has been launched.\ Try processing payments for physical goods and services more easily. {% endupdate %} {% update date="2025-04-18" tags="api" %} ## Launched Toss Login feature that lets you log in easily with a Toss account **Toss Login feature**has been launched.\ With a single consent, you can connect sign-up, login, and information sharing all at once. {% endupdate %} {% update date="2025-04-15" tags="api" %} ## Launched functional push feature that can bring users back at key moments **functional push and notification features**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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.