안녕하세요, 앱인토스입니다.
SDK 3.x 미만 버전을 사용 중인 미니앱은 2026년 10월 5일부터 콘솔에서 신규 등록이 제한됩니다.
아직 SDK 3.x로 전환하지 않으셨다면, 10월 5일 전까지 반드시 업데이트를 완료해 주세요.
■ 신규 등록 제한 안내
- 시행일 : 2026년 10월 5일부터
- 대상 : WebView 및 Unity 프로젝트를 운영 중인 전체 파트너사
- 내용 : SDK 3.x 미만 버전으로는 신규 등록이 불가능해요.
■ SDK 3.x, 무엇이 달라지나요?
SDK 3.x는 내부 처리 로직을 클라이언트가 아닌 서버 기반으로 변경한 버전이에요. SDK 이슈가 발생해도 파트너사의 재배포 없이 앱인토스 서버에서 바로 수정하고 반영할 수 있어, 미니앱 생태계 전체의 안정성을 높일 수 있어요.
함수 호출 방식도 Device, Share, User 같은 Domain 단위로 재편됐어요. (예: openCamera() → Device.openCamera())
다만, 기존 SDK 2.x 방식의 코드도 별도 수정 없이 그대로 작동하니, 지금 바로 전체 코드를 바꾸실 필요는 없어요.
로컬 브라우저에서 바로 테스트할 수 있는 AIT Devtools를 활용하면, 샌드박스 없이도 미니앱 동작을 바로 확인할 수 있어요.
■ SDK 3.x 전환 방법
- WebView : 마이그레이션 가이드(SDK 3.x 마이그레이션 | SDK | 앱인토스 개발자센터)를 참고해 주세요.
- Unity SDK : 별도의 설정 변경 없이, git 패키지를 3.x 버전으로 업데이트하면 전환이 완료돼요.
■ 주의해주세요
- SDK 3.x 출시 후에는 SDK 2.x로 롤백할 수 없어요.
- AIT Devtools 및 QR코드로 충분히 테스트한 후 출시해 주세요.
- SDK 3.1.1 이상은 기존 Origin을 그대로 사용해서 별도 설정이 필요 없지만,
SDK 3.0.0 ~ 3.1.0은 Origin이 달라 최신 버전으로 업데이트해 주세요.
| SDK 버전 | 실제 서비스 환경 | 콘솔 QR 테스트 환경 |
|---|---|---|
| 2.x / 3.1.1 이상 | https://<appName>.apps.tossmini.com |
https://<appName>.private-apps.tossmini.com |
| 3.0.0 ~ 3.1.0 | https://<appName>.web.tossmini.com |
https://<appName>.private-web.tossmini.com |
반드시 10월 5일까지 SDK 업데이트를 완료해 주세요.
SDK 전환을 준비해 주시는 파트너분들께 감사드립니다.
궁금한 점은 개발자 커뮤니티로 문의해 주세요.
감사합니다.
앱인토스 드림