주요 기능 등록하기
주요 기능은 사용자가 비게임 미니앱 상세에서 특정 기능으로 바로 들어올 수 있게 해주는 기능이에요. 홈 화면을 거치지 않고 원하는 세부 기능으로 바로 이동해요.
콘솔에서 등록하기
1. 앱 출시 메뉴의 '주요 기능' 탭 들어가기
2. 주요 기능 입력하기
주요 기능은 최대 3개까지 등록할 수 있어요.
주요 기능은 '한국어 기능 이름'과 '영어 기능 이름'을 함께 입력해야 해요.
한국어 기능 이름: 10자 이내, 특수문자는
:.만 허용, 이모지 사용 불가영어 기능 이름: 15자 이내, 첫 글자만 대문자, 특수문자는
:.만 허용, 이모지 사용 불가
기능 이름은 토스 UX 라이팅에 따라 '~하기'나 명사형으로 작성해 주세요.
예) '송금 내역 확인하기', '해외 송금하기', '여행 예약 내역 확인하기'
미니앱 서비스의 기능이 드러나게 작성해 주세요. '예약 확인하기', '내역 확인', '보러가기', '시청하기'처럼만 쓰면, 무슨 서비스의 기능인지 사용자가 알기 어려워요.
사용자가 바로 접속할 기능 이름과 이동할 intoss://pages 주소를 입력해 주세요.
주요 기능 URL에 정상 접속되지 않으면 반려될 수 있어요.
쿼리 파라미터를 설정할 수 있어요.
모두 입력했다면 '검토 요청하기'를 눌러주세요. 검토에는 영업일 기준 1~2일이 걸릴 수 있어요.
주요 기능 정보 확인하기
검토 결과는 '주요 기능' 탭에서 확인할 수 있어요.
'주요 기능' 탭에서 주요 기능만 따로 등록하거나 수정할 수 있어요.
주요 기능만 따로 추가·수정하면 주요 기능만 검토하기 때문에, 영업일 기준 1~2일이 걸릴 수 있어요.
이미 운영 중인 미니앱에서 새로 추가하거나 수정할 때도, 주요 기능에 정상 접속되는지 꼭 확인해 주세요.
개발 환경별 피처 구성
Webview
라우터 경로를 피처 주소와 매핑해요.
피처 주소를 intoss://{appName}/search로 입력하면 해당 페이지로 이동할 수 있어요.
React Native
Next.js와 비슷한 파일 기반 라우팅을 써요.
/pages/search.tsx → /search 경로 매핑 → intoss://{appName}/search로 진입 시 렌더링
자세한 구조는 파일 기반 라우팅 이해하기를 참고하세요.