It doesn’t have to be perfect. Build your mini app for a chance to win up to KRW 3 million.
웨비나 신청하기
Ctrlk
SupportCommunityConsole
For the complete documentation index, see llms.txt. This page is also available as Markdown.
RSS feed

Release Notes

Improving game and local storage APIs

Added an API to subscribe to hiding the game info overlay

that lets you subscribe to the point when the game info overlay disappears Game.subscribeInfoOverlayHidden has been added.

Added APIs to read and save multiple Storage values at once

that lets you retrieve and save multiple local storage values at once Storage.getItems, Storage.setItems has been added.

Changing the service Origin for WebView mini apps

Starting with SDK 3.1.1, services will be served from the same Origin as SDK 2.x.

Environment
Before
After

Production environment

https://{appName}.web.tossmini.com

https://{appName}.apps.tossmini.com

Console QR test environment

https://{appName}.private-web.tossmini.com

https://{appName}.private-apps.tossmini.com

View the community announcement

Improving web-framework stability and developer experience

In this release, we've made the default behavior of mini apps more stable and improved the developer experience of the CLI and Devtools.

  • webView.pullToRefreshEnableddefault value to falsechanged. This change prevents unintended refreshes while scrolling, and if needed, apps-in-toss.config.ts of defineConfigdirectly in trueset it to.

  • Fully improved ait --help. We organized examples based on the actual bin name, ait, and expanded Korean/English output, color detection, ait --version, and descriptions of key commands.

  • During build appName, brand, webBundle so that settings are validated. brand.primaryColor Added a default value as well.

  • Improved AIT Devtools' mock customization options and test fidelity.

    You can configure the initial mock state directly in the bundler settings, and add or edit the IAP product catalog. You can also test subscription product mocks, screen-on prevention, and accessory button events more realistically.

Providing a new test environment

An AIT Devtools package that lets you test mini apps directly in a local browser has been added.

It is configured automatically if you scaffold a new project or migrate from version 2.x to 3.x.

For details, SDK 3.x migration guideplease refer to it.

The structure of WebView projects has been improved

The parameters and return values are the same as the existing SDK 2.x, so you can apply it without any separate code changes.

  • Configuration file structure changes: the config file name and some properties have changed.

  • Server-based processing: we changed the SDK's internal processing logic to run on the server rather than the client.

  • Stable issue response: even if an SDK issue occurs, it can be fixed and applied on the Apps in Toss server without the partner needing to redeploy.

This update is to improve the stability of the mini app ecosystem and keep the SDK on a stable version.

For details, SDK 3.x migration guideplease refer to it.

The banner image specifications for React Native mini apps have been updated

Banner images are now displayed in the same format as WebView mini apps.

Fixed an issue where a white screen appeared when accessing mini apps on iOS

Heavy users of the Toss app experienced an issue where a white screen intermittently appeared when accessing WebView-based mini apps in the iOS environment. Updating to the latest version will fix the issue.

Fixed the WebView flickering issue

Resolved an issue where the WebView would intermittently flicker when using bottom sheets.

Fixed the bottom touch issue in navigation bar transparent mode

In the navigation bar option, transparent was true, fixed an issue where the bottom of the screen could not be touched. You can now touch the bottom of the screen normally even in transparent mode.

Promotion, Smart Send, and Toss Pay APIs now support user identifier key (hash) authentication

Previously, users could only be identified with a userKey issued through Toss Login. Now you can also call the APIs below with the hash value received from the user identifier key issuance feature.

A validation API is also provided to check whether the user identifier key is valid.

You can hide the icon and app name in the navigation bar

navigationBarto withTitle option has been added. withTitlethe falseIf you set it to, the icon and app name will be hidden together in the navigation bar. For details, navigation bar please refer to the document.

Toss Pay recurring payments (auto-payment) have been launched

Once a user registers a payment method for the first time, they can make automatic payments periodically afterward 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.

When you press the X button in a game app, a quit confirmation modal appears

In game apps, pressing the X button in the navigation bar shows a quit confirmation modal. Non-game apps exit immediately without a quit confirmation modal.

The --timeout option has been added to the app bundle deployment command

ait deploy in the command, which adjusts the maximum wait time for checking deployment status --timeout option is available. For details, Test the Toss app please refer to the document.

Added non-game navigation bar theme settings

You can set the theme of the non-game navigation bar by adding just a simple value to the config file. Transparent mode and dark mode are supported. For details, navigation bar please refer to the document.

Launched the user information feature

Retrieves information stored in Toss with user consent getConsentedUserDatahas 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 details, User information please refer to the document.

Fixed an IAP subscription payment callback bug

On web, IAP.createSubscriptionPurchaseOrder when payment is completed processProductGrant fixed an issue where the callback was not called. To prepare for grant errors, purchase recovery logicwe recommend integrating it as well.

Removed the mini app exit modal

The quit confirmation modal that appeared when pressing the X button in the navigation bar has been removed.

Added album media selection and PDF viewer features

Select photos and videos from the user's album fetchAlbumItemsand open PDF data in a native viewer openPDFViewer functions have been added. For details, Albumand Open PDF viewer please refer to the document.

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 via callback to decide whether to send the notification. For details, Smart Send development guideplease refer to it.

Added Toss Pay recurring payments (auto-payment) feature

Once a user registers a payment method for the first time, they can make automatic payments periodically afterward 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 details, Toss Pay recurring payments development guideplease refer to it.

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 in the same way. We also changed the existing 'Game Login' name to 'User Identifier Key Issuance'.

SDK 2.4.1 stability improvements update

We identified and fixed some API behavior issues in the React 19 environment. We released SDK 2.4.1 with the related issues resolved.

A review request feature has been added

that lets you request a review at the moment when users have felt the app's value sufficiently requestReview feature has been added. Through this feature, partners can naturally encourage reviews at moments of positive user experience and increase the value of the mini app. For details, Mini app review request please refer to the document.

Enhanced ait CLI help and added release note option

ait of the CLI --help clarified and expanded the content. Also, deploy when running the command -m "release note" option, you can pass release notes together.

Added subscription status lookup function

You can now use getSubscriptionInfoto 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.

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 settings.

  • Fixed an issue where font size changed according to system settings in Android WebView.

  • Added the ability to set microphone permissions.

Improved build and deployment stability

Fixed issues occurring during the build and upload process.

Improved promotion reward feature

Promotion rewards can now be issued without a server even in non-game environments. For details, Promotion guideplease refer to it.

SDK 2.0.5 stability improvements update

Additional errors were identified in SDK 2.0.4 and fixed. We released SDK 2.0.5 with the related issues resolved.

Improved an issue where logging did not work

Fixed an issue where logs were not being collected properly in some environments.

The left button in the quit confirmation modal has been changed to [Close]

The left button in the quit confirmation modal is standardized to [Close]. [Cancel] is not used because it could be misunderstood as canceling the user's current task. For details, Navigation bar in common settings please refer to the document.

SDK 2.0.2 stability improvements update

Some function behavior issues were identified in SDK 2.0.1 and fixed. We released SDK 2.0.2 with the related issues resolved.

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, you will not be able to upload bundles built with 1.x to the console. The build command has granite buildchanged from ait buildto.

Launched bulk messaging feature

A feature that lets you send the same template message to multiple users at once bulk messaging featurehas been launched. With a single request, up to 2,500 messagescan be sent. Use it efficiently when repeated sending is needed, such as for large campaigns or announcements.

Launched Toss one-touch authentication feature

Toss one-touch authentication featurehas been newly launched. Now users can easily complete identity verification with a single touch in the Toss app, without entering personal information. This feature can be integrated with the Toss verification API's USER_NONE type, and skipConfirmDoc parameter trueif set to, you can skip the certificate confirmation step.

Launched Toss verification feature

Compare the personal information entered by the user with their Toss account information, and Toss app verificationa feature has been launched that can verify identity through. Now you can safely verify key information such as CI, name, and mobile phone number.

Changed in-app purchase order lookup status values

With the addition of the in-app purchase product grant process, PAYMENT_COMPLETED the PAYMENT_COMPLETED status has been added.

Launched in-app purchase feature

that allows direct purchase of paid items inside the app in-app purchase featurehas been launched. Sell digital goods, content, permissions, and more with ease, and grow revenue quickly with a short purchase flow.

Launched promotion feature

that grants Toss points based on specific user actions promotion featurehas been launched. Use promotions to drive conversions and improve performance across the funnel, including repeat visits and virality.

Launched Toss Pay feature

that lets you pay quickly and securely within the Toss app Toss Pay featurehas been launched. Try making payments for physical goods and services with ease.

Launched Toss Login feature

that lets you log in easily with a Toss account Toss Login featurehas been launched. With a single consent, you can connect sign-up, login, and information sharing all at once.

Launched functional push feature

that can bring users back at key moments functional push and notification featurehas been launched. Make active use of it to improve retention and drive conversions.