> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/operation/console-workspace.md).

# 미니앱 등록하기

### 1. 회원가입하기

앱인토스를 이용하려면 먼저 [앱인토스 콘솔](https://apps-in-toss.toss.im/)에 접속해 회원가입을 해주세요. 회원가입은 토스 비즈니스 회원을 기반으로 진행돼요.

가입하려면 두 가지 조건이 필요해요.

* 만 19세 이상이어야 해요.
* 본인 명의로 로그인된 토스 앱이 있어야 해요.

***

### 2. 워크스페이스 만들기

워크스페이스는 팀원들이 함께 프로젝트를 관리하는 공간이에요.

* 워크스페이스는 사업자당 1개만 만들 수 있어요.
* 이름은 다른 워크스페이스와 겹치게 정할 수 없어요.

팀이나 프로젝트 이름처럼 쉽게 알아볼 수 있는 이름을 붙여주세요. 이름은 나중에 바꿀 수 있어요.

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2Fy3ZFmPosUeo9BZW9zqgQ%2Fimage.png?alt=media&#x26;token=ff3e94b5-ef2d-455e-827c-0170b27554e6" alt=""><figcaption></figcaption></figure>

***

### 3. 멤버 관리하기

워크스페이스를 만든 사람에게 '대표관리자' 권한이 자동으로 부여돼요.

대표관리자는 워크스페이스 운영을 책임지고, 서비스 약관에 동의할 수 있어요. 대표관리자는 관리자 중에서만 신청할 수 있고, 구성원은 신청할 수 없어요. [대표관리자 권한 위임하기](https://developers-apps-in-toss.toss.im/guide/operation/undefined)

#### 멤버 초대하기

'멤버' 메뉴에서 '+초대하기'를 누르고 팀원의 이메일을 입력하면, 권한별로 초대할 수 있어요.

* **관리자**: 멤버 관리, 설정 변경 등 모든 권한을 가져요.
* **구성원**: 함께 작업할 수 있지만, 멤버 초대와 설정 변경은 할 수 없어요.

<figure><img src="/files/KnSop1rtzWauhvQEM9xj" alt=""><figcaption></figcaption></figure>

***

### 4. 앱 등록하기

워크스페이스를 만든 뒤 '앱' 메뉴에서 '+등록하기'를 눌러 앱을 등록해주세요. 아직 개발이 끝나지 않은 앱도 미리 등록할 수 있어요.

> **개발 앱과 라이브 앱을 나눠서 관리하고 싶다면?**
>
> 같은 워크스페이스 안에서 앱을 구분해 등록해주세요. 테스트용 앱과 실제 배포용 앱을 따로 등록할 수 있어요.

<figure><img src="/files/LSHOjkjIy3IxOyiDfP0y" alt=""><figcaption></figcaption></figure>

아래 정보만 입력하면 앱을 만들 수 있어요.&#x20;

나머지 앱 정보는 준비되는 대로 입력하면 되고, 각 항목은 임시 저장할 수 있어요.&#x20;

<figure><img src="/files/iODxlIrzd28tcwMYzkq6" alt=""><figcaption></figcaption></figure>

#### 앱 이름

토스 앱에 노출되는 이름이에요. 어떤 서비스인지 바로 알 수 있게 지어주세요.

* 이미 쓰고 있는 브랜드명이나 서비스명이 있다면, 그대로 쓰는 걸 추천해요.
* 앱 이름은 앱 정보에서 나중에 바꿀 수 있어요.

**영문명은 아래 규칙을 따라주세요.**

* 15자 이내의, 발음하기 쉬운 명사형 이름으로 지어요.
* 명령문이나 동사구는 쓰지 않아요.
  * 'Book a Taxi'가 아니라 'GoRide Taxi'처럼 브랜드명 형태로 지어요.
* 한글 앱 이름과 뜻이 다른 일반 단어를 단독으로 쓰지 않아요.
  * 'Taxi'가 아니라 'GoRide Taxi'로 지어요.
* 단어를 3개 이상 쓰거나, 읽기 어려운 복합어는 피해요.

#### appName

앱 스킴을 호출하면, 이 ID를 기준으로 앱인토스 서비스로 이동해요.

* `intoss://` 형식으로 구성돼요. 규칙을 지키지 않으면 서버 인증서 발급에 실패할 수 있어요.
* appName은 한 번 등록하면 바꿀 수 없으니 신중하게 입력해주세요.

#### 앱 유형

만들려는 앱이 게임인지 게임이 아닌지에 따라 앱 유형을 선택해주세요. 선택한 유형에 따라 이후에 입력할 앱 정보 항목이 달라져요.

***

### 5. 앱 정보 입력하기

앱을 출시하기 전에 앱 정보 메뉴에서 \[수정하기] 버튼을 눌러 나머지 앱 정보를 모두 입력하고 검토를 요청해주세요. 앱 정보 검토가 끝나야 앱을 출시할 수 있어요.

<figure><img src="/files/kJc1TI6BEWJgfSZXpqUO" alt=""><figcaption></figcaption></figure>

#### 5-1. 기본 정보

<figure><img src="/files/Nv0JrHE08rV5b69Dmrh3" alt=""><figcaption></figcaption></figure>

#### 부제

어떤 서비스를 이용할 수 있는지 쉽게 이해할 수 있게, 짧게 적어주세요.

* 전체 메뉴에서 검색했을 때 미니앱 이름 아래에 노출될 수 있어요.
* 비속어와 느낌표 등은 쓸 수 없어요.

#### 상세 설명

상세 설명을 바탕으로 토스 홈 광고 대상으로 선정될 수 있어요. 사용자가 서비스에서 무엇을 경험할 수 있는지 최대한 구체적으로 적어주세요.

사용자가 서비스를 처음 실행한 뒤 핵심 기능을 경험하기까지의 과정을 적어주세요. '서비스 접속 → 행동 → 결과' 흐름에 따라 문장으로 풀어서 설명하면 좋아요. 사용자가 실제로 무엇을 보고, 무엇을 누르고, 어떤 경험을 하는지를 중심으로 자세히 적어주세요.

<details>

<summary>예시: 장학금 정보 서비스</summary>

(X) 필터를 제공해요.

**(O) 해외 장학금, 거주 지역, 가구원 정보를 기반으로 필터를 제공해요.**

(X) 알림을 신청하면 나에게 딱 맞는 장학금 정보를 알려줘요.

**(O) 알림을 신청하면 거주 지역과 가구원 정보를 기반으로, 나에게 딱 맞는 장학금의 금액과 접수 기한을 알림으로 알려줘요.**

</details>

<details>

<summary>예시: 디펜스 게임</summary>

우산을 잡고 내려오는 적들

번개, 화살, 주먹 등의 무기 사용

2번의 턴마다 무기 고르기 가능

몬스터를 10번 무찌르면 골드 20개 받기

오른쪽 출석 버튼을 누르면, 첫 출석 시 다이아 100개 받기

</details>

#### 사용 연령

지금 앱인토스는 만 19세 이상 사용자에게만 제공돼요.

#### 고객문의 이메일

문의에 원활하게 대응할 수 있도록 고객문의 이메일 정보를 입력해주세요.

***

#### 5-2. 카테고리 및 노출

<figure><img src="/files/AWUYuH3tt7wfF92N3tlq" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Mh5o6WzihwyWKs9UxaS1" alt=""><figcaption></figcaption></figure>

#### 카테고리

출시하는 미니앱에 맞는 카테고리를 선택해주세요. 실제 서비스와 다르면, 검토 과정에서 알맞은 카테고리로 바꾼 뒤 안내해드려요.

<details>

<summary>게임 앱</summary>

출시하는 게임의 장르에 맞는 카테고리를 선택해주세요.

웹보드 게임이라면, '웹보드 여부'를 꼭 체크해야 해요. [웹보드 게임 서비스 주의사항](https://developers-apps-in-toss.toss.im/intro/caution#web-board)

</details>

<details>

<summary>비게임 앱</summary>

대분류, 중분류, 소분류까지 설정할 수 있어요.

이미 선택한 중분류와 같은 카테고리는 또 선택할 수 없어요. 예를 들어 중분류를 '여행'으로 선택했다면, 두 번째 카테고리로 '여행'을 다시 선택할 수 없어요.

</details>

#### 노출 정보

아래는 '카테고리 및 노출' 영역에서 입력할 내용이에요. 모든 미니앱에 공통으로 필요한 내용과, 게임인지 아닌지에 따라 필요한 내용을 각각 확인할 수 있어요.

#### 앱 로고

앱 로고는 토스 앱 전체 메뉴의 미니앱 홈에 노출돼요. 게임이 아닌 앱은 상단 공통 내비게이션 바에도 노출돼요.

* 작은 화면에서도 선명하게 보여야 해요.
* 서비스 특성이 한눈에 드러나야 해요.
* 다른 앱과 헷갈리지 않아야 하고, 저작권 문제가 없어야 해요.
* 다크 모드에서도 자연스럽게 보이는 색과 형태를 써주세요.
* 정사각형 600 × 600px, PNG 파일로 만들어주세요. (배경색 필수, 투명 배경은 쓸 수 없어요.)
* 토스에서 제공하는 아이콘과 이미지 리소스 등은 앱 로고로 쓸 수 없어요. (2차 가공 포함)

#### 썸네일 이미지 (게임 앱)

썸네일 이미지는 토스 앱의 여러 지면에 쓰이고, 사용자가 서비스에 접속하기 전에 가장 먼저 보는 이미지예요. 어떤 서비스인지 한눈에 이해할 수 있고, 좋은 인상을 받을 수 있게 만들어주세요.

* 1932 × 828px, PNG 파일로 업로드해주세요.
* 미니앱의 핵심 플레이 화면이나 주요 기능이 보이는 이미지를 써주세요.
* 선명한 고화질 이미지를 쓰고, 작은 이미지를 늘려서 쓰지 마세요.
* 정해진 규격에 맞춰 만들고, 빈 공간을 색이나 블러로 채우지 마세요.
* 비속어, 정치적 표현 등 편견이 담긴 요소는 넣지 마세요.
* 텍스트는 너무 많이 쓰지 마세요. 필요하다면 로고나 짧은 문구만 적절히 넣어주세요.
* 로고를 쓸 때는 서비스명이 명확히 보이는지 확인해주세요.
* 다른 앱과 헷갈리지 않게 차별화해주세요.
* 저작권 문제가 없는 이미지를 써주세요.
* 토스에서 제공하는 아이콘과 이미지 리소스 등은 썸네일로 쓸 수 없어요. (2차 가공 포함)

<details>

<summary>권장하는 예시</summary>

<figure><img src="/files/MdaJj4I9CRVyG1M0CDRq" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>권장하지 않는 예시</summary>

<figure><img src="/files/Ri3JGHj9XsI05llkTcEI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Bz7RhgMjHTUg4yOxn08V" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/gacDzrZpnaS0wpr0jzQM" alt=""><figcaption></figcaption></figure>

</details>

#### 스크린샷

스크린샷 이미지는 토스 검색 결과와 앱 미리보기 등에 쓰여요.

* 제출은 선택 사항이에요. 다만 제출한 미니앱부터 순서대로 반영되어, 미니앱 홈에 먼저 노출될 예정이에요.
* 직접 만든 이미지와 스크린샷 형태 모두 쓸 수 있어요.
* 검색 결과와 앱 미리보기에 쓰이니, 미니앱의 특징을 한눈에 알 수 있는 이미지를 써주세요.
* 이미지를 넣는다면 세로형은 최소 3장, 가로형은 최소 1장을 업로드해주세요.
  * 세로형 규격: 636 × 1048px, PNG 파일
  * 가로형 규격: 1504 × 741px, PNG 파일

#### 리더보드 (게임 앱)

사용자 점수를 기준으로 순위를 매기는 기능이에요. 기록할 점수 단위와 정렬 기준 등 정책을 설정해주세요.

***

#### 5-3. 게임 등급분류

게임은 등급 심의 증빙 자료를 꼭 제출해야 해요. 입력한 정보는 토스 앱 5.240.0 버전부터 아래와 같이 노출돼요.

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FXDgRiVytPp5G0qnAzO20%2Fimage.png?alt=media&#x26;token=81067b30-7996-4abd-939a-2e01440e8353" alt=""><figcaption></figcaption></figure>

#### 1) 스토어에서 출시 심사를 받았다면, 스토어 URL을 입력해주세요

오픈마켓(앱스토어, 구글 플레이 스토어, 원스토어, Microsoft Store)에서 등급 분류를 받았다면, 오픈마켓에 출시된 게임 페이지의 URL과 자체등급분류 게임물 정보를 입력해야 해요.

> **게임 등급 정보와 자체등급분류 게임물 정보를 왜 입력해야 하나요?**&#x20;
>
> 게임물관리위원회 규정에 따라, 자체등급분류사업자에게 등급을 받은 게임과 앱인토스로 출시하려는 게임이 같은 게임인지 확인하기 위해서예요. 이를 지키지 않으면 등급을 받지 않은 게임물로 여겨져, 시정 권고나 수사 의뢰, 행정처분 의뢰 등의 조치로 이어질 수 있어요.

<figure><img src="/files/tWwI6FBnOE0NXP3vDge7" alt=""><figcaption></figcaption></figure>

**게임 등급 정보**

'스토어 링크'로 바꾼 뒤, 게임이 출시된 페이지의 링크를 입력해주세요.

**기본 정보**

* 사업자라면, 사업자등록증에 있는 정보를 입력해주세요.
* 개인 개발자(비사업자)라면, 개인 본인 정보를 입력해주세요.

**자체등급분류 게임물 정보**

아래 정보를 입력하려면, 게임물관리위원회의 '자체등급분류 게임물 조회' 페이지에서 오픈마켓에 출시한 게임을 먼저 조회해주세요.

* **등록자명**: 스토어에 나오는 등록자명을 입력해주세요. 구글 플레이 스토어는 개발자명을, 애플 앱스토어는 제공자명을 입력해주세요.
* **자체등급분류사업자명**: '구글', '애플', '원스토어'처럼 자체등급분류를 진행한 오픈마켓의 사업자명을 입력해주세요.
* **등급분류일자**: 게임물관리위원회에서 조회한 등급 분류 일자와 똑같이 입력해주세요.
* **등급분류번호**: 게임물관리위원회에서 조회한 등급 분류 번호와 똑같이 입력해주세요.
* **이용등급**: 게임물관리위원회에서 조회한 이용등급과 똑같은 등급을 선택해주세요.
* **내용정보**: 게임물관리위원회에서 조회한 내용정보에 표시된 항목을 모두 선택해주세요. 전체 이용가라도 내용정보가 있다면 선택해주세요.
* **대표자 인감 또는 사인 이미지**: 대표자의 인감이나 사인 이미지를 첨부해주세요. 흰 종이에 인감 도장을 찍거나 서명한 뒤, 그 이미지를 첨부해주세요.

**게임의 주요 내용이 담긴 화면 첨부 (플레이 화면)**

* 자체등급분류를 받은(오픈마켓에 출시한) 게임 플레이 화면 2장과, 앱인토스로 출시하는 게임의 플레이 화면 2장을 각각 첨부해주세요.
* 따로 편집하지 말고, 원본 플레이 화면을 그대로 첨부해주세요.
* 내용정보에 선정성이나 폭력성이 있다면, 그에 해당하는 게임 화면 이미지를 각각 첨부해주세요.

<details>

<summary>게임물 등록자명과 사업자명이 다르면 어떻게 하나요?</summary>

자체등급분류 게임물에 적힌 등록자명과 실제 사업자명이 다르면 검수에서 반려돼요. 다른 사유를 소명할 수 있다면, 증빙 자료나 사유를 추가로 제출해주세요.

* **개인(비사업자)**: 등록자명과 사업자명이 다른 사유를 적어주세요.
* **사업자(개인 또는 법인)**: 등기부등본을 제출해, 사업체 이름이 바뀌었다는 등의 사유를 소명해주세요.

</details>

#### 2) 게임물관리위원회에서 심의를 받았다면, 증명서를 PDF 파일로 첨부해주세요

**게임 등급 정보**

'게임물 등급분류증명서'로 바꾼 뒤, 등급 심의 증명서를 PDF로 첨부해주세요. [게임물 등급분류 신청 방법](https://toss.im/apps-in-toss/blog/game_rating_classification)

**자체등급분류 게임물 정보**

게임물 등급분류증명서에 나온 내용과 똑같이 입력해주세요.

***

### 6. 검토 요청하기

앱 등록 가이드라인에 맞게 입력을 마친 뒤 **'검토 요청하기'** 버튼을 눌러주세요. 검토는 영업일 기준 1\~2일 걸리고, 결과는 콘솔과 이메일로 안내해드려요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers-apps-in-toss.toss.im/guide/operation/console-workspace.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.