> 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-08-18" tags="3.0.4,sdk" %}
## Improve web-framework stability and developer experience
In this release, we made the mini app's default behavior more stable and improved the developer experience of the CLI and Devtools.
* `webView.pullToRefreshEnabled`the 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`directly in `true`set it to.
* We thoroughly improved ait --help. We organized the examples around the actual bin name, ait, and added Korean/English output, color detection, ait --version, and descriptions of the key commands.
* During build, `appName`, `brand`, `webBundle` settings are validated. `brand.primaryColor` We also added default values.
* We improved the mock customization options and test fidelity for AIT Devtools.
You can configure the mock initial state directly in the bundler settings, and add or edit the IAP product catalog. You can also test subscription product mocks, screen sleep prevention, and accessory button events more closely to real behavior.
{% endupdate %}
{% update date="2026-08-04" tags="3.0.2,sdk" %}
## We provide a new testing environment
The AIT Devtools package has been added, letting you test mini apps directly in a 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/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 it without changing any code.
* Configuration file structure changes: the configuration file name and some properties have changed.
* Server-based processing: we changed the SDK's internal processing logic to run on the server instead of the client.
* Stable issue response: even if SDK issues occur, we can fix and apply them on the App in Toss server without partners redeploying the app.
This update is to improve the stability of the mini app ecosystem and keep the SDK on a stable version.
For more details, [SDK 3.x migration guide](/documentation/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 changed
Banner images are now displayed with the same specifications as WebView mini apps.
{% endupdate %}
{% update date="2026-07-21" tags="2.10.7,sdk" %}
## The issue where a white screen appeared when accessing mini apps on iOS has been fixed
Heavy users who use the Toss app a lot occasionally saw a white screen 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" %}
## The WebView flickering issue has been fixed
We resolved the issue where the WebView would intermittently flicker when using a bottom sheet.
{% endupdate %}
{% update date="2026-07-10" tags="2.10.5,sdk" %}
## The bottom touch issue in transparent mode for the navigation bar has been fixed
of the navigation bar option `transparent` has been fixed.\
Now you can touch the bottom of the screen normally even in transparent mode.
{% endupdate %}
{% update date="2026-07-16" tags="api" %}
## User identity key (hash) authentication is supported in Promotion, Smart Sending, 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 from the user identity 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 Sending** : [Build Smart Sending](https://developers-apps-in-toss.toss.im/smart-message/develop.html)
* **Toss Pay one-time payment** : [Build Toss Pay one-time payment](https://developers-apps-in-toss.toss.im/tosspay/develop.html)
* **Toss Pay recurring payment** : [Build Toss Pay recurring payment](https://developers-apps-in-toss.toss.im/tosspay/auto-pay.html)
A validation API is also provided so you can check whether the user identity 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` has been added.\
`withTitle`to `false`If you set it to, the icon and app name will be hidden together 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 launched
Once a user registers a payment method for the first time, they can make recurring automatic payments thereafter without additional authentication.\
By issuing a billing key and processing recurring 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 termination confirmation modal appears
When you press the X button in the navigation bar in a game app, a termination confirmation modal is displayed.\
Non-game apps exit immediately without a termination confirmation modal.
{% endupdate %}
{% update date="2026-06-16" tags="2.9.0,sdk" %}
## --timeout option has been added to the app bundle deployment command
`ait deploy` the maximum waiting time for checking deployment status in the command `--timeout` option.\
For more details, [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 setting 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 config file.\
It supports transparent mode and dark mode.\
\
For more details, [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" %}
## The user information feature has launched
Before sending notifications that require prior consent, such as restock notifications or event notifications, `getConsentedUserData`has been added.\
You can request up to 8 items such as name, mobile phone number, and address.\
You can use it with just the SDK, without a separate server.\
\
For more details, [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 IAP subscription payment callback bug
On the web, `IAP.createSubscriptionPurchaseOrder` when payment is completed `processProductGrant` we fixed the 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 recommended to be integrated as well.
{% endupdate %}
{% update date="2026-05-27" tags="2.6.1,sdk" %}
## Remove 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
fetchAlbumItems `for selecting photos and videos from the user's album`and `openPDFViewer` have been added.\
\
For more 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) 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 UI from the user to consent to receiving them.\
You can receive the consent result via callback and decide whether to send the notification.\
\
For more details, [Smart Sending developer 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 additional authentication.\
By issuing a billing key and processing recurring payments through API calls alone, it can be used for various recurring billing models such as subscription services, regular deliveries, and memberships.\
\
For more details, [Toss Pay recurring payment developer 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 identity key issuance feature
Previously, only games could issue a unique hash-based user identity key without a server.\
Now non-game apps can issue a user identity key in the same way.\
We also changed the existing 'game login' name to 'user identity 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 fixed.
{% endupdate %}
{% update date="2026-04-01" tags="2.4.0,sdk" %}
## The review request feature has been added
that lets you request a review when the user has sufficiently experienced the value of the app `requestReview` feature has been added.\
Through this feature, partners can naturally prompt reviews at moments when the user experience is positive, and increase the value of the mini app.\
\
For more 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" %}
## ait CLI help improvements and release note option added
`ait` CLI's `--help` content has been made clearer.\
Also, `deploy` when running the command `-m "release notes"` option can be used to pass release notes together.
{% endupdate %}
{% update date="2026-03-30" tags="2.2.0,sdk" %}
## Added subscription status lookup function
You can now use `getSubscriptionInfo`to check 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 the font size of banner ads changed depending on the system font settings.
* We fixed an issue where the font size changed depending on system settings in Android WebView.
* We added a feature to configure 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 grant feature
Promotion grants are now possible without a server even in non-game environments.\
For more 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
We found and fixed additional errors in SDK 2.0.4.\
We released SDK 2.0.5 with the related issues fixed.
{% endupdate %}
{% update date="2026-03-10" tags="2.0.4,sdk" %}
## Improved 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 termination confirmation modal has been changed to \[Close]
We are standardizing the left button text in the termination confirmation modal to \[Close].\
\[Cancel] is not used because it may be mistaken for canceling the task the user is doing.\
\
For more 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
We found and fixed some function behavior issues in SDK 2.0.1.\
We released SDK 2.0.2 with the related issues fixed.
{% 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 supporting 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 can no longer be uploaded to the console.\
The build command has `granite build`from `ait build`changed to.
{% endupdate %}
{% update date="2026-02-25" tags="api" %}
## Mass message sending feature launched
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 cases that require repeated sending, such as large campaigns and 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 `USER_NONE` type of the Toss authentication API, 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
A feature has been launched that compares the personal information entered by the user with Toss membership information, and **Toss app authentication**can be used to verify identity.\
Now you can securely verify key information such as CI, name, and mobile phone number.
{% endupdate %}
{% update date="2025-09-19" tags="api" %}
## Changed the status values for in-app purchase order lookup
The in-app purchase product grant process was added, so `PAYMENT_COMPLETED` status has been added.
{% endupdate %}
{% update date="2025-08-05" tags="api" %}
## In-app purchase feature launched
An **in-app purchase feature**has been launched that lets you buy paid products directly inside the app.\
Easily sell digital products, content, and permissions, and quickly grow revenue with a short purchase flow.
{% endupdate %}
{% update date="2025-04-28" tags="api" %}
## Promotion feature launched
A **promotion feature**that grants Toss points based on specific user actions has been launched.\
Use promotions to drive conversions and improve performance across the funnel, including re-visits and virality.
{% endupdate %}
{% update date="2025-04-25" tags="api" %}
## Toss Pay feature launched
A **Toss Pay feature**that lets you pay quickly and securely inside the Toss app has been launched.\
Make it easy to pay for physical products and services.
{% endupdate %}
{% update date="2025-04-18" tags="api" %}
## Toss Login feature launched
A **Toss Login feature**that lets you easily log in with a Toss account has been launched.\
With a single consent, you can connect sign-up, login, and information provision all at once.
{% endupdate %}
{% update date="2025-04-15" tags="api" %}
## Functional push feature launched
A **functional push and notification feature**that can bring users back at key moments 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.
