안녕하세요, 앱인토스입니다.
WebView 및 Unity 프로젝트를 운영 중인 전체 파트너사 여러분께 안내드립니다.
미니앱 생태계의 안정성 강화를 위해 SDK 3.x 전환을 안내드려요.
2026년 9월 14일까지 SDK 3.x로 업데이트를 완료해 주세요.
■ 주요 안내
- 전환 기간 : 2026년 9월 14일까지
- 전환 대상 : WebView 및 Unity 프로젝트를 운영 중인 전체 파트너사
- 전환 사유 :
- SDK 내부 처리 로직을 클라이언트가 아닌 서버 기반으로 변경해서, SDK 이슈가 발생해도 파트너사의 재배포 없이 앱인토스 서버에서 바로 수정하고 반영할 수 있어요.
- 미니앱 생태계 전체의 안정성을 높이고, SDK를 안정적인 버전으로 유지하기 위한 조치예요.
■ SDK 3.x 주요 개선 사항
- WebView 프로젝트 구조 개선 : 설정 파일 이름 및 일부 프로퍼티 변경
- 클라이언트 SDK 고도화
- 파라미터 · 반환값은 기존 SDK 2.x와 동일해서 연동 코드 변경 부담이 적어요
■ Unity SDK 파트너사 안내
Unity SDK를 사용 중이라면 별도의 설정 변경 없이, git 패키지를 3.x 버전으로 업데이트하면 전환이 완료됩니다.
■ 유의사항
- 로컬 브라우저에서 바로 테스트할 수 있는 AIT Devtools가 제공돼요.
- 기존에는 샌드박스 앱을 설치하고 로그인해야 했지만, 이제는 이 과정 없이 로컬 브라우저만 띄우면 바로 미니앱 동작을 확인할 수 있어요.
- SDK 3.x 출시 후 롤백이 안돼요
- SDK 3.x 이상이 적용된 앱 번들을 출시하면 SDK 2.x 버전으로 롤백할 수 없어요.
- AIT Devtools 및 QR코드로 충분히 테스트한 후 출시해 주세요.
- CORS가 변경돼요
- SDK 3.x 버전부터는 CORS가 아래와 같이 변경돼요.
- Origin 허용 목록에 다음 도메인을 등록하지 않으면 API 요청이 차단될 수 있으니 등록하세요.
https://<appName>.web.tossmini.com: 실제 서비스 환경https://<appName>.private-web.tossmini.com: 콘솔 QR 테스트 환경
■ SDK 3.x 마이그레이션 가이드
더 나은 서비스 안정성을 제공하기 위한 조치이니, 9월 중순까지 SDK 3.x로 전환을 완료해 주세요.
기타 문의 사항이 있을 경우 커뮤니티로 문의해주세요.
감사합니다.