Skip to content

릴리즈 노트

앱인토스 제품 및 API·SDK의 새로운 기능과 변경 사항을 알려드려요.


웹보드 게임 출시 가능

고스톱, 포커 등 웹보드 게임을 앱인토스에서 출시할 수 있게 되었어요.
웹보드 게임을 보유한 파트너들이 합법적이고 안전하게 서비스를 운영할 수 있는 기반이 마련되었어요.
또한 유저 인증 과정에서 간편한 토스 인증을 활용하면 별도의 인증 시스템을 구축할 필요 없이, 일관된 UX로 유저 이탈을 최소화할 수 있어요.

자세한 내용은 웹보드 게임 주의사항 문서를 참고해주세요.

게임 로그인 기능 출시

새로운 게임 로그인 기능을 통해 별도의 서버 구축이나 유저 동의 과정 없이 유저를 식별할 수 있어요.
게임 로그인으로 얻은 유저 식별값을 활용해 프로모션 기능도 사용할 수 있어요.
게임 로그인을 적용해 이탈률을 낮추고, 혜택탭 노출을 통해 트래픽을 키워보세요.

자세한 내용은 게임 로그인 문서를 참고해주세요.

토스 인증 기능 출시

사용자가 입력한 개인정보를 토스 가입 정보와 대조하고, 토스 앱 인증을 통해 신원을 확인할 수 있는 기능이 출시되었어요.
이제 CI, 이름, 휴대전화번호 등 주요 정보를 안전하게 확인할 수 있어요.

자세한 내용은 토스 인증 문서를 참고해주세요.

인앱 광고 v2.0 성과 대시보드 오픈

콘솔에서 인앱 광고 v2.0 성과 대시보드를 확인할 수 있어요.
성과 데이터를 기반으로 미니앱의 완성도를 높여보세요.

자세한 내용은 인앱 광고 문서를 참고해주세요.

토스 홈 광고 기능 출시

토스 앱 홈 상단 배너에 광고를 노출할 수 있는 토스 홈 광고 기능이 출시되었어요.
토스 홈 광고를 통해 토스 사용자에게 임팩트 있는 메시지를 전달해보세요.

자세한 내용은 토스 홈 광고 문서를 참고해주세요.

인앱 광고 v2.0 출시

인앱 광고 v2.0이 출시되었어요. 이제 원하는 대로 광고 ID를 생성할 수 있고, 구글 애드몹 실시간 입찰을 통해 가장 수익이 높은 광고가 자동으로 노출돼요.
추후 다양한 광고 네트워크도 추가될 예정이에요.
※ 기존 v1.0 버전은 추후 deprecated 예정이니, v2.0으로 업데이트해주세요.

자세한 내용은 인앱 광고 문서를 참고해주세요.

인앱 결제 내역 확인 기능 오픈

콘솔에서 인앱 결제의 결제 및 환불 내역을 확인할 수 있어요.
환불 요청이 들어온 주문건을 승인/반려하고 결과를 쉽게 조회해보세요.

자세한 내용은 인앱 결제 문서를 참고해주세요.

혜택탭 노출 프로모션 기능 출시

사용자의 특정 행동에 따라 토스 포인트를 지급하는 프로모션 기능을 이제 혜택탭에 노출할 수 있어요.
콘솔에서 혜택탭 노출 여부를 설정하고, 높은 트래픽을 경험해보세요.

자세한 내용은 프로모션 문서를 참고해주세요.

공유 리워드 기능 출시

연락처 모듈을 통해 토스 유저의 연락처를 불러오고, [기회 받기] 공유 리워드를 제공할 수 있어요.
공유 리워드를 도입해 ‘초대 → 신규 유입 → 재방문·재공유’로 이어지는 자연스러운 바이럴 선순환 구조를 만들어보세요.

자세한 내용은 공유 리워드 문서를 참고해주세요.

인앱 결제 기능 출시

앱 내부에서 유료 상품을 직접 구매할 수 있는 인앱 결제 기능이 출시되었어요.
디지털 상품, 콘텐츠, 권한 등을 손쉽게 판매하고, 짧은 구매 흐름으로 매출을 빠르게 늘려보세요.

자세한 내용은 인앱 결제 문서를 참고해주세요.

게임 프로필 & 리더보드 기능 출시

사용자가 게임 시작 전 프로필을 등록할 수 있고, SDK 업데이트만으로 자동 노출돼요.
또한 유저들의 점수를 보여주는 리더보드 기능으로 경쟁과 소셜 요소를 더할 수 있어요.
게임 체류시간과 리텐션을 높이고, 공유를 통한 신규 유입도 기대할 수 있어요.

자세한 내용은 게임 프로필 & 리더보드 문서를 참고해주세요.

세그먼트 기능 오픈

콘솔에서 세그먼트를 생성해 원하는 타겟에게 메시지를 보낼 수 있어요.
세그먼트를 활용해 푸시, 알림 발송과 토스 홈 광고 노출까지 설정해보세요.

자세한 내용은 세그먼트 문서를 참고해주세요.

광고성 메시지 기능 오픈

마케팅 수신에 동의한 사용자에게 광고성 메시지를 보낼 수 있어요.
세그먼트를 활용해 신규 유입, 리텐션 향상 등 다양한 마케팅 목적에 활용해보세요.

자세한 내용은 푸시, 알림 문서를 참고해주세요.

로그(이벤트) 기능 출시

사용자의 행동과 노출을 기록하는 로그(이벤트) 기능이 출시되었어요.
데이터를 기반으로 이탈 지점을 파악하고, 전환율과 트래픽을 개선해보세요.

자세한 내용은 로그(이벤트) 문서를 참고해주세요.

앱빌더 출시

파트너사를 위한 전용 UI 디자인 툴 앱빌더가 출시되었어요.
별도 설치 없이 웹에서 바로 사용할 수 있고, TDS 라이브러리와 주요 컴포넌트가 포함되어 있어 빠르게 미니앱을 완성할 수 있어요.

자세한 내용은 앱빌더 문서를 참고해주세요.

대시보드 오픈

DAU, 성별, 연령, 리텐션 등 주요 지표를 한눈에 볼 수 있는 대시보드가 오픈되었어요.
지표를 기반으로 서비스 개선과 트래픽 향상 전략을 세워보세요.

자세한 내용은 대시보드 문서를 참고해주세요.

인앱 광고 기능 출시

앱 내부에 노출되는 전면형·보상형 광고 기능이 출시되었어요.
광고를 통해 자연스럽게 수익화를 시작하고, 이탈은 줄이고 ARPDAU·LTV는 높여보세요.

자세한 내용은 인앱 광고 문서를 참고해주세요.

프로모션 기능 출시

사용자의 특정 행동을 기준으로 토스 포인트를 지급하는 프로모션 기능이 출시되었어요.
프로모션으로 전환을 유도하고, 재방문·바이럴까지 퍼널 전반의 성과를 높여보세요.

자세한 내용은 프로모션 문서를 참고해주세요.

토스 페이 기능 출시

토스 앱 내에서 빠르고 안전하게 결제할 수 있는 토스 페이 기능이 출시되었어요.
실물 상품·서비스 결제를 간편하게 진행해보세요.

자세한 내용은 토스 페이 문서를 참고해주세요.

토스 로그인 기능 출시

토스 계정으로 간편하게 로그인할 수 있는 토스 로그인 기능이 출시되었어요.
한 번의 동의로 가입, 로그인, 정보 제공까지 한 번에 연결할 수 있어요.

자세한 내용은 토스 로그인 문서를 참고해주세요.

기능성 푸시 기능 출시

핵심 순간에 유저를 다시 불러올 수 있는 기능성 푸시, 알림 기능이 출시되었어요.
리텐션 향상과 전환 유도를 위해 적극 활용해보세요.

자세한 내용은 푸시, 알림 문서를 참고해주세요.

토스 인증 기능 출시

사용자가 입력한 개인정보를 토스 가입 정보와 대조하고, 토스 앱 인증을 통해 신원을 확인할 수 있는 기능이 출시되었어요.
이제 CI, 이름, 휴대전화번호 등 주요 정보를 안전하게 확인할 수 있어요.

자세한 내용은 토스 인증 개발하기 문서를 참고해주세요.

인앱 결제 주문 조회 상태값 변경

인앱 결제 상품 지급 과정이 추가되어 PAYMENT_COMPLETED 상태가 추가되었어요.

자세한 내용은 인앱 결제 개발하기 문서를 참고해주세요.

인앱 결제 기능 출시

앱 내부에서 유료 상품을 직접 구매할 수 있는 인앱 결제 기능이 출시되었어요.
디지털 상품, 콘텐츠, 권한 등을 손쉽게 판매하고, 짧은 구매 흐름으로 매출을 빠르게 늘려보세요.

자세한 내용은 인앱 결제 개발하기 문서를 참고해주세요.

프로모션 기능 출시

사용자의 특정 행동을 기준으로 토스 포인트를 지급하는 프로모션 기능이 출시되었어요.
프로모션으로 전환을 유도하고, 재방문·바이럴까지 퍼널 전반의 성과를 높여보세요.

자세한 내용은 프로모션 개발하기 문서를 참고해주세요.

토스 페이 기능 출시

토스 앱 내에서 빠르고 안전하게 결제할 수 있는 토스 페이 기능이 출시되었어요.
실물 상품·서비스 결제를 간편하게 진행해보세요.

자세한 내용은 토스 페이 개발하기 문서를 참고해주세요.

토스 로그인 기능 출시

토스 계정으로 간편하게 로그인할 수 있는 토스 로그인 기능이 출시되었어요.
한 번의 동의로 가입, 로그인, 정보 제공까지 한 번에 연결할 수 있어요.

자세한 내용은 토스 로그인 개발하기 문서를 참고해주세요.

기능성 푸시 기능 출시

핵심 순간에 유저를 다시 불러올 수 있는 기능성 푸시, 알림 기능이 출시되었어요.
리텐션 향상과 전환 유도를 위해 적극 활용해보세요.

자세한 내용은 푸시, 알림 개발하기 문서를 참고해주세요.

내비게이션바 가변 아이콘 동작 버그 수정

내비게이션바에 동적으로 가변 아이콘을 추가하거나 삭제할 때 버그를 수정했어요.
이제 동적으로 아이콘 추가 이후 이벤트 리스너를 등록해도 정상적으로 작동해요.

안드로이드 모바일 환경 감지 이슈를 해결했어요

안드로이드에서 userAgent를 통해 모바일 환경임을 감지할 수 없었던 문제를 해결했어요. 기능상의 변경은 없어요.

가로모드 게임 내비게이션바 위치 개선

가로모드에서 실행되는 게임 미니앱의 내비게이션바 위치가 화면 레이아웃에 맞게 조정되었어요. 이제 가로모드 환경에서도 UI가 안정적으로 표시돼요.

인앱 결제 getPendingOrders 함수 개선

getPendingOrders 함수에 sku 필드가 새로 추가되었어요.
결제가 완료되었지만 상품이 아직 지급되지 않은 주문 목록을 조회할 때, orderId뿐 아니라 sku 값도 함께 확인할 수 있습니다.

  • 안드로이드 최소 지원 버전이 5.234.0 로 상향되었어요.
    앱 버전이 최소 지원 버전(안드로이드 5.234.0, iOS 5.231.0)보다 낮으면 undefined를 반환해요.
  • 반환 객체 프로퍼티 구조가 변경되었어요.

자세한 내용은 getPendingOrders 문서를 참고해주세요.

게임 로그인 기능이 추가되었어요

게임 미니앱에서 유저를 식별할 수 있는 키 값을 가져오는 함수를 제공해요.
getUserKeyForGame 함수를 통해 별도의 서버 연동 없이도 토스 로그인 기능처럼 유저를 구분할 수 있어요.

게임 프로모션(토스 포인트) 기능이 추가되었어요

getUserKeyForGame 으로부터 받은 유저 식별자(hash)를 사용해 프로모션(토스 포인트) 기능을 실행하는 함수 를 제공해요.
grantPromotionRewardForGame 함수를 통해 별도의 서버 연동 없이도 게임 미니앱 내에서 유저에게 토스 포인트를 지급하고, 혜택탭에 노출할 수 있어요.

토스앱 최소 지원 버전 상향

모든 유저의 식별자를 안정적으로 확보하기 위해 토스앱 최소 지원 버전이 5.232.0 으로 상향되었어요.
지원 버전 미만의 환경에서는 미니앱 진입 시 업데이트 안내 화면이 표시돼요.

React Native 게임을 지원해요

React Native 환경에서도 게임을 지원할 수 있게 되었어요.
게임 전용 네비게이션바, "~님 반가워요" 토스트, 프로필 생성 분기 등 게임 프로필 관련 기능이 추가됐어요.
granite.config.tsappsInToss() 플러그인 옵션에 다음처럼 설정하면 사용할 수 있어요.

appsInToss({
  ...
  appType: 'game',
  ...
});

백 이벤트 동작을 개선했어요

일부 상황에서 백 이벤트가 올바르게 작동하지 않던 문제를 수정했어요.

게임 브릿지 화면이 다크모드로 고정돼요

게임 브릿지 화면은 항상 다크모드로 표시돼요.
React Native와 WebView 모두 동일하게 적용돼요.

인앱 결제 기능을 개선했어요

인앱 결제 SDK에 구매 복원 기능이 추가됐어요. 사용자는 결제 이력(주문 목록)과 미결 주문을 조회하고, 상품 지급 처리를 할 수 있어요.

  • IAP.getCompletedOrRefundedOrders → 구매 완료·환불 주문 조회
  • IAP.getPendingOrders → 미결 주문 조회
  • IAP.completeProductGrant → 상품 지급 처리

토스 인증 기능이 추가되었어요

토스 인증을 통해 사용자의 신원을 간편하게 확인할 수 있어요.
입력한 개인정보를 토스에 등록된 정보와 대조하고, 토스 앱 인증으로 본인 확인 절차를 진행할 수 있어요.

  • 토스 인증을 통해 CI, 이름, 휴대전화번호 등을 안전하게 확인할 수 있어요.
  • 웹보드 게임은 관련 법령에 따라 본인 확인이 필수이므로, 토스 인증을 이용해 간편하게 연동할 수 있어요.

WebView backEvent 문제를 해결했어요

WebView에서 backEvent 이벤트 감지가 정상 동작 안하던 문제를 수정해서 배포했어요.

granite 에 누락된 훅을 추가했어요

bedrock 에서 granite로 마이그레이션에서 누락된 훅을 추가했어요

  • useWaitForReturnNavigator
  • useOverlay, OverlayProvider

TDS 접근 방식이 개선되었어요

이제 TDS 사용을 위해 별도의 npm 권한 설정 이나 가이드 페이지 접근을 위한 IP 등록이 필요하지 않아요.

React Native에서 다크모드 버그가 수정되었어요

ReactNative 의 granite.config.tsbridgeColorMode 값으로 다크모드 설정이 안되던 이슈를 수정했어요.

내비게이션바에 미니앱 공유하기 기능이 추가되었어요

토스 앱 5.230.0 버전 이상부터 지원돼요. 샌드박스 앱에서는 지원되지 않아요.

인앱 결제 지급 완료 과정이 추가되었어요

인앱결제 (IAP.createOneTimePurchaseOrder) 에 지급 완료 과정이 추가되었어요.
호환성 주의 (Breaking Change): 함수 인터페이스가 변경되어, 업데이트 시 코드 수정이 필요해요.

내비게이션바에 홈버튼 버그가 수정되었어요

공통 네비게이션바에서 홈 버튼 클릭 시 루트 페이지로 이동하지 않던 버그를 해결했어요.

안드로이드 뒤로가기 동작 버그가 수정되었어요.

안드로이드 WebView에서 window.history 사용 시 뒤로가기가 동작하지 않던 이슈가 해결되었어요.

게임 WebView 내비게이션바 디자인을 변경했어요

게임 WebView 내비게이션바 투명화가 되지 않던 문제를 해결하고, 디자인을 변경했어요.

내비게이션바의 뒤로가기 동작 버그가 수정되었어요

WebView,React Native 내비게이션바 뒤로가기 동작 시 미니앱이 종료되는 버그를 수정했어요.

안드로이드 백버튼 동작 버그가 수정되었어요

안드로이드 시스템 백버튼 뒤로가기 동작시 미니앱이 종료처리되는 버그를 수정했어요.

권한 함수가 추가되었어요

getPermission 함수를 통해 현재 권한 상태가 어떤지 확인할 수 있어요.
openPermissionDialog 함수를 통해 필요한 권한을 다시 요청할 수 있어요.

내비게이션바가 개편되었어요

내비게이션바의 디자인이 변경되고, 문의/신고하기 기능이 추가되었어요.
콘솔에 등록한 고객센터와 홈페이지 링크가 자동으로 노출돼요.
신고하기를 통해 제보를 받을 수 있고 파트너사분들께 내용도 전달드려요.

체류 시간 측정 기능을 지원해요

미니앱의 체류 시간을 측정하기 위한 기능이 내재되었어요.
추후 콘솔 대시보드에서 체류 시간을 확인할 수 있어요.

TDS 버전 업데이트를 진행해주세요

TDS를 안정적으로 사용하기 위해 버전을 업데이트해주세요.

  • React Native : @apps-design-system/react-nativev1.1.1 버전 이상 사용해주세요.
  • WebView : @apps-design-system/mobile, @apps-design-system/mobile-aitv2.1.0 버전 이상 사용해주세요.

토스앱 최소 지원 버전 상향

토스앱 최소 지원 버전이 상향되었어요.
지원 버전 미만의 환경에서는 미니앱 진입 시 업데이트 안내 화면이 표시돼요.

  • 안드로이드 : 5.220.0
  • iOS : 5.221.0

기반 프레임워크가 Granite로 변경되었어요

기반 프레임워크가 Bedrock에서 Granite로 변경되었어요.
이에 따라 제공되는 CLI를 통해 마이그레이션을 진행해주세요.
마이그레이션 후 반드시 개발자 테스트를 진행해야해요.

  • npm : npx ait migrate granite
  • yarn : yarn ait migrate granite