> 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/release-note.md).
# 릴리즈 노트
{% updates format="full" %}
{% update date="2026-08-18" tags="3.0.4,sdk" %}
## web-framework 안정성과 개발 경험을 개선해요
이번 릴리즈에서는 미니앱의 기본 동작을 더 안정적으로 조정하고, CLI와 Devtools의 개발 경험을 개선했어요.
* `webView.pullToRefreshEnabled`의 기본값을 `false`로 변경했어요. 스크롤 중 의도치 않은 새로고침을 막기 위한 변경이며, 필요한 경우 `apps-in-toss.config.ts` 의 `defineConfig`에서 직접 `true`로 설정해주세요.
* ait --help를 전면 개선했어요. 실제 bin 이름인 ait 기준으로 예시를 정리하고, 한국어/영어 출력, 컬러 감지, ait --version, 주요 커맨드 설명을 보강했어요.
* 빌드 시 `appName`, `brand`, `webBundle` 설정을 검증하도록 했어요. `brand.primaryColor` 기본값도 추가했어요.
* AIT Devtools의 mock 커스터마이즈 옵션과 테스트 충실도를 개선했어요.
mock 초기 상태를 번들러 설정에서 직접 구성할 수 있고, IAP 상품 카탈로그를 추가·편집할 수 있어요. 구독 상품 mock, 화면 꺼짐 방지, 액세서리 버튼 이벤트도 실제 동작에 더 가깝게 테스트할 수 있어요.
{% endupdate %}
{% update date="2026-08-04" tags="3.0.2,sdk" %}
## 새로운테스트 환경을 제공해요
로컬 브라우저에서 미니앱을 바로 테스트할 수 있는 AIT Devtools 패키지가 추가되었어요.
새로운 프로젝트를 스캐폴딩했거나 2.x 버전에서 3.x 로 마이그레이션한 경우 자동으로 설정돼요.
자세한 내용을 [SDK 3.x 마이그레이션 문서](/documentation/integration/sdk-3.x.md)를 참고해주세요.
{% endupdate %}
{% update date="2026-08-03" tags="3.0.1,sdk" %}
## WebView 프로젝트의 구조가 개선되었어요
파라미터와 반환값은 기존 SDK 2.x와 동일해서 별도 코드 수정 없이 적용할 수 있어요.
* 설정 파일 구조 변경 : 설정 파일 이름과 일부 프로퍼티가 변경됐어요.
* 서버 기반 처리 : SDK 내부 처리 로직을 클라이언트가 아닌 서버에서 처리하도록 변경했어요.
* 안정적인 이슈 대응 : SDK 이슈가 발생해도 파트너사의 재배포 없이 앱인토스 서버에서 수정하고 반영할 수 있어요.
미니앱 생태계의 안정성을 높이고 SDK를 안정적인 버전으로 유지하기 위한 업데이트예요.
자세한 내용을 [SDK 3.x 마이그레이션 문서](/documentation/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 환경에서 WebView 기반 미니앱에 접속할 때 간헐적으로 흰 화면이 나타나는 문제가 있었어요.\
최신 버전으로 업데이트하면 해당 증상이 사라져요.
{% endupdate %}
{% update date="2026-07-13" tags="2.10.6,sdk" %}
## 웹뷰 깜빡임 문제가 수정되었어요
바텀시트를 사용할 때 웹뷰가 간헐적으로 깜빡이던 현상을 해결했어요.
{% endupdate %}
{% update date="2026-07-10" tags="2.10.5,sdk" %}
## 내비게이션 바 투명 모드에서 하단 터치 문제가 수정되었어요
내비게이션 바 옵션의 `transparent` 가 true인 상태에서 화면 하단이 터치되지 않던 문제가 수정되었어요.\
이제는 투명 모드에서도 화면 하단을 정상적으로 터치할 수 있어요.
{% endupdate %}
{% update date="2026-07-16" tags="api" %}
## 프로모션, 스마트 발송, 토스페이 API에서 사용자 식별키(hash) 인증을 지원해요
기존에는 토스 로그인으로 발급받은 userKey로만 사용자를 식별할 수 있었어요.\
이제는 사용자 식별키 발급 기능으로 받은 hash 값으로도 아래 API를 호출할 수 있어요.
* **프로모션** : [서버를 통해 프로모션 포인트 지급하기](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)
* **토스페이 일회성 결제** : [토스페이 일회성 결제 개발하기](https://developers-apps-in-toss.toss.im/tosspay/develop.html)
* **토스페이 정기결제** : [토스페이 정기결제 개발하기](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" %}
## 토스페이 정기결제(자동결제) 기능이 출시됐어요
사용자가 최초 1회 결제 수단을 등록하면, 이후 별도 인증 없이 주기적으로 자동 결제할 수 있어요.\
빌링키를 발급받아 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` 옵션을 사용할 수 있어요.\
자세한 내용은 [토스 앱 테스트하기](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" %}
## 사용자 정보 기능을 출시했어요
사용자 동의를 받아 토스에 저장된 정보를 불러오는 `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 구독 결제 콜백 버그 수정
웹에서 `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)를 참고해 주세요.
#### 토스페이 정기결제(자동결제) 기능 추가
사용자가 최초 1회 결제 수단을 등록하면, 이후 별도 인증 없이 주기적으로 자동 결제할 수 있어요.\
빌링키를 발급받아 API 호출만으로 반복 결제를 진행하는 방식으로, 구독 서비스·정기 배송·멤버십 등 다양한 반복 과금 모델에 활용할 수 있어요.\
\
자세한 내용은 [토스페이 정기결제 개발 문서](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`를 사용할 수 있어요.\
해당 기능은 토스앱 Android 5.253.0, iOS 5.253.0 이상에서 사용할 수 있어요.
{% endupdate %}
{% update date="2026-03-24" tags="2.1.0,sdk" %}
## 폰트 크기 및 권한 설정 개선
폰트 크기 동작을 안정화하고 권한 설정 기능을 추가했어요.
* 시스템 폰트 설정에 따라 배너 광고의 폰트 크기가 달라지던 문제를 수정했어요.
* 안드로이드 웹뷰에서 시스템 설정에 따라 폰트 크기가 변경되던 문제를 수정했어요.
* 마이크 권한을 설정할 수 있는 기능을 추가했어요.
{% endupdate %}
{% update date="2026-03-18" tags="2.0.9,sdk" %}
## 빌드 및 배포 안정성 개선
빌드 및 업로드 과정에서 발생하던 문제를 수정했어요.
{% endupdate %}
{% update date="2026-03-18" tags="2.0.8,sdk" %}
## 프로모션 지급 기능 개선
이제 비게임 환경에서도 서버 없이 프로모션 지급이 가능해졌어요.\
자세한 내용은 [프로모션 가이드](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이 출시되었어요.\
토스앱 RN 0.84 업데이트에 맞춰 SDK 1.x는 더 이상 지원되지 않아요.\
3월 23일 이후에는 1.x로 빌드한 번들을 콘솔에 업로드할 수 없어요.\
빌드 커맨드가 `granite build`에서 `ait build`로 변경되었어요.
{% endupdate %}
{% update date="2026-02-25" tags="api" %}
## 메시지 대량 발송 기능 출시
여러 사용자에게 동일한 템플릿 메시지를 한 번에 발송할 수 있는 **메시지 대량 발송 기능**이 출시되었어요.\
한 번의 요청으로 최대 **2,500건**까지 발송할 수 있어요.\
대량 캠페인, 공지 안내 등 반복 발송이 필요한 경우 효율적으로 활용해보세요.
{% endupdate %}
{% update date="2025-11-12" tags="api" %}
## 토스 원터치 인증 기능 출시
**토스 원터치 인증 기능**을 새롭게 출시했어요.\
이제 사용자는 개인정보 입력 없이 토스앱에서 한 번의 터치로 간편하게 본인인증을 완료할 수 있어요.\
\
본 기능은 토스 인증 API의 `USER_NONE` 타입으로 연동할 수 있으며,\
`skipConfirmDoc` 파라미터를 `true`로 설정하면 인증서 확인 단계를 건너뛸 수 있어요.
{% endupdate %}
{% update date="2025-10-20" tags="api" %}
## 토스 인증 기능 출시
사용자가 입력한 개인정보를 토스 가입 정보와 대조하고, **토스 앱 인증**을 통해 신원을 확인할 수 있는 기능이 출시되었어요.\
이제 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" %}
## 프로모션 기능 출시
사용자의 특정 행동을 기준으로 토스 포인트를 지급하는 **프로모션 기능**이 출시되었어요.\
프로모션으로 전환을 유도하고, 재방문·바이럴까지 퍼널 전반의 성과를 높여보세요.
{% endupdate %}
{% update date="2025-04-25" tags="api" %}
## 토스페이 기능 출시
토스 앱 내에서 빠르고 안전하게 결제할 수 있는 **토스페이 기능**이 출시되었어요.\
실물 상품·서비스 결제를 간편하게 진행해보세요.
{% endupdate %}
{% update date="2025-04-18" tags="api" %}
## 토스 로그인 기능 출시
토스 계정으로 간편하게 로그인할 수 있는 **토스 로그인 기능**이 출시되었어요.\
한 번의 동의로 가입, 로그인, 정보 제공까지 한 번에 연결할 수 있어요.
{% 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 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/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.
