> 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/deploy.md).

# 미니앱 출시하기

토스 앱에서 최종 테스트를 마쳤다면, 앱인토스 콘솔에서 검토를 요청하고 미니앱을 출시할 수 있어요.

### 1. 사전 점검하기

#### 1-1) 게임, 비게임 출시 가이드

출시 전에 검수 가이드와 체크리스트를 꼭 확인하세요. [게임](https://developers-apps-in-toss.toss.im/checklist/app-game)·[비게임](https://developers-apps-in-toss.toss.im/checklist/app-nongame) 출시 가이드를 모두 확인해 개발이 끝났는지 점검해 주세요. 가이드를 지키지 않으면 검토 단계에서 반려될 수 있어요.

#### 1-2) 앱 번들 업로드 시 주의 사항

앱 번들은 압축 해제 기준 100MB 이하만 업로드할 수 있어요. 이미지·사운드·영상 같은 리소스를 모두 포함하면 용량을 넘길 수 있으니, 리소스 파일은 빌드와 분리해서 관리해 주세요.

리소스 관리는 이렇게 하는 걸 권장해요.

* 앱 실행에 꼭 필요한 최소 리소스만 번들에 포함하세요.
* 대용량 리소스는 외부 스토리지나 CDN에서 내려받도록 구성해 주세요.
* 추가 리소스는 단계적으로 내려받는 방식(Lazy Loading)을 적용하면 사용자 경험이 좋아져요.

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FvaJm4N1VhruvHhi7QH9z%2F%E1%84%87%E1%85%A5%E1%86%AB%E1%84%83%E1%85%B3%E1%86%AF%20%E1%84%8C%E1%85%B5%E1%86%A8%E1%84%8C%E1%85%A5%E1%86%B8%20%E1%84%8B%E1%85%A5%E1%86%B8%E1%84%85%E1%85%A9%E1%84%83%E1%85%B3%20%E1%84%92%E1%85%A1%E1%86%AF%20%E1%84%84%E1%85%A2%2097.png?alt=media&amp;token=3eca711d-0bcf-4c52-9d4c-d2856ef962cb" alt=""><figcaption></figcaption></figure>

***

### 2. 검토 요청하기

테스트를 마친 뒤 콘솔의 '검토 요청하기' 버튼을 누르면 검토가 시작돼요. 검토는 영업일 기준 최대 3일 걸리고, 앱 카테고리에 따라 7일 이상 걸릴 수 있어요.

* 테스트를 1번 이상 완료해야 검토 요청 버튼이 활성화돼요.
* 검토 요청은 한 번에 한 버전만 제출할 수 있어요.

검토를 요청한 뒤 수정할 버그를 발견했다면, '요청 취소하기' 버튼을 눌러 검토를 취소하세요. 그다음 수정한 새 번들(`.ait`)을 업로드하고 다시 검토를 요청하면 돼요.

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FcsUExLlWzp8RoFEXz43x%2F%E1%84%87%E1%85%B5%E1%84%80%E1%85%A6%E1%84%8B%E1%85%B5%E1%86%B7%2083.png?alt=media&amp;token=1440e524-a2bc-45cc-8e55-7fee2c472479" alt=""><figcaption></figcaption></figure>

#### 검토가 반려된 경우

'반려 사유 보기' 버튼을 눌러 사유를 확인한 뒤, 문제를 해결한 새 번들을 업로드하고 다시 검토를 요청해 주세요. 반려 사유에 대해 더 궁금한 점이 있다면 [채널톡](https://apps-in-toss.channel.io/workflows/787658)으로 문의할 수 있어요.

***

### 3. 출시하기

번들이 승인되면 검수 결과를 이메일로 안내해드려요. 이후 콘솔에서 '출시하기' 버튼을 누르면 미니앱이 사용자에게 공개돼요.

출시하면 전체 사용자에게 즉시 반영돼요. 반드시 충분히 테스트한 뒤 출시해 주세요.

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2F4hikUgHNPAGvvwKERub9%2F%E1%84%87%E1%85%B5%E1%84%80%E1%85%A6%E1%84%8B%E1%85%B5%E1%86%B7%2032.png?alt=media&amp;token=b753d8a1-2dd6-4393-ae53-bd3ae270ff0f" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**테스트 환경과 실제 환경의 차이**

테스트 환경과 실제 라이브 환경은 CORS 정책과 네트워크 동작이 다를 수 있어요. 특히 아래 기능은 실제 환경에서도 반드시 다시 확인해 주세요.

* 메모리·리소스 사용량
* 네트워크 요청(CORS): Origin 허용 목록에 아래 도메인을 등록해야 해요.\
  SDK 버전에 따라 달라요.<br>

  SDK 3.x

  * 실제 서비스 환경: `https://<appName>.web.tossmini.com`
  * QR 테스트 환경: `https://<appName>.private-web.tossmini.com`

  \
  SDK 1.x \~ 2.x

  * 실제 서비스 환경: `https://<appName>.apps.tossmini.com`
  * QR 테스트 환경: `https://<appName>.private-apps.tossmini.com`
* 권한 처리
* 로그인·세션 유지
* 실제 결제·인증 기능

테스트 환경에서는 정상이어도 실제 환경에서는 오류가 날 수 있어요.
{% endhint %}

***

### 4. 출시 후 관리하기

출시한 뒤에는 앱인토스 콘솔에서 버전 관리와 업데이트를 할 수 있어요. 필요에 따라 새 번들을 올리거나, 기존 버전을 유지·관리할 수 있어요.

#### 4-1. 새 버전(업데이트) 배포하기

* 새 기능을 추가하거나 오류를 수정했다면, 기존과 같은 방식으로 새 앱 번들(`.ait`)을 업로드하세요.
* 업로드한 번들은 다시 검토 요청 → 승인 → 출시 단계를 거쳐요.
* 승인된 뒤 '출시하기' 버튼을 누르면 새 버전이 기존 앱을 대체해요.

출시한 버전은 사용자에게 즉시 반영되니, 미리 충분히 테스트한 뒤 업로드해 주세요.

#### 4-2. 롤백하기

* '앱 출시' 메뉴에서 기존에 출시한 버전 목록을 확인할 수 있어요.
* 문제가 생기면 이전 버전으로 롤백할 수 있어요.
* 롤백할 버전을 선택한 뒤 '출시하기' 버튼을 누르세요.

롤백도 사용자에게 즉시 반영되니, 버전을 신중히 선택해 주세요.

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2Fr4B2aVhF5yBdGqRDIWCZ%2F%E1%84%80%E1%85%A6%E1%84%8B%E1%85%B5%E1%86%B7%2063.png?alt=media&amp;token=8b3289c5-2d37-4950-a472-fe118125339b" alt=""><figcaption></figcaption></figure>

#### 4-3. 긴급 수정(핫픽스)

앱 실행에 심각한 오류가 생기면 [채널톡](https://apps-in-toss.channel.io/workflows/787658)으로 바로 문의해 주세요. 긴급 상황에서는 빠르게 대응해드려요.

#### 4-4. 출시 후 모니터링

출시 직후에는 예상치 못한 오류나 성능 이슈가 생길 수 있어요. 아래 항목을 중심으로 모니터링하는 걸 권장해요.

* 주요 오류 로그와 크래시 로그
* Sentry 설정을 통한 Sentry 모니터링
* API 응답 지연·실패율
* 사용자 피드백과 사용성 문제
  * 내비게이션 바의 '신고하기' 기능으로 사용자 의견을 받을 수 있어요.
  * 접수된 피드백은 콘솔의 '신고 내역' 메뉴에서 확인할 수 있어요.
* 외부 리소스·CDN 로딩 지연이나 실패 이슈

#### 4-5. 사후 검수

앱인토스는 사용자에게 높은 수준의 미니앱 경험을 제공하기 위해, 출시한 뒤에도 미니앱 검수를 진행해요. 사후 검수에서 개선이 필요한 점이 확인되면 개선을 요청드릴 수 있어요. 법·정책 위반 사항이 발견되면 운영 정책에 따라 긴급 운영 중단 조치가 먼저 진행될 수 있어요.


---

# 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/deploy.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.