안녕하세요, 앱인토스입니다.
미니앱 생태계의 안정성 강화를 위해 WebView 프로젝트의 SDK 3.x 전환을 안내드려요.
2026년 9월 14일까지 SDK 3.x로 업데이트를 완료해 주세요.
■ 주요 안내
- 전환 기간 : 2026년 9월 14일까지
- 전환 대상 : WebView 프로젝트를 운영 중인 전체 파트너사
- 전환 사유 :
- SDK 내부 처리 로직을 클라이언트가 아닌 서버 기반으로 변경해서, SDK 이슈가 발생해도 파트너사의 재배포 없이 앱인토스 서버에서 바로 수정하고 반영할 수 있어요.
- 미니앱 생태계 전체의 안정성을 높이고, SDK를 안정적인 버전으로 유지하기 위한 조치예요.
■ SDK 3.x 주요 개선 사항
- WebView 프로젝트 구조 개선 : 설정 파일 이름 및 일부 프로퍼티 변경
- 클라이언트 SDK 고도화
- 파라미터 · 반환값은 기존 SDK 2.x와 동일해서 연동 코드 변경 부담이 적어요
■ 유의사항
- 현재 샌드박스 환경에서는 SDK 3.x 테스트를 지원하지 않아요.
- SDK 3.x 부터는 별도의 개발환경 테스트 툴이 제공될 예정이에요.
- 테스트 툴은 익일 오후 중 제공될 예정이며, 관련 내용은 별도로 공지드리겠습니다.
- SDK 3.x 출시 후 롤백이 안돼요
- SDK 3.x 이상이 적용된 앱 번들을 출시하면 SDK 2.x 버전으로 롤백할 수 없어요.
- 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로 전환을 완료해 주세요.
기타 문의 사항이 있을 경우 커뮤니티로 문의해주세요.
감사합니다.