> 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).

# 미니앱 출시하기

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

<figure><img src="/files/4H0y9LFnWfRPMAXl8vX1" alt=""><figcaption></figcaption></figure>

### 1. 사전 점검하기

**① 검수 가이드 확인하기**

출시 전 반드시 **검수 가이드 및 체크리스트**를 확인하세요. 게임/비게임 출시 가이드를 모두 확인하여 개발이 완료되었는지 점검해 주세요. 가이드를 준수하지 않으면 **검토 단계에서 반려될 수 있어요.**

**② 앱 번들 업로드 시 주의사항**

**용량 정책**

* 앱 번들은 압축 해제 기준 **100MB 이하**만 업로드할 수 있어요.
* 이미지, 사운드, 영상 등 모든 리소스를 포함하면 용량을 초과할 수 있어요.
* 리소스 파일은 **빌드와 분리**하여 관리해 주세요.

**권장 사항**

* 앱 실행에 필요한 **최소한의 리소스만 번들에 포함**하세요.
* 대용량 리소스는 **외부 스토리지 또는 CDN 다운로드** 방식으로 구성하는 것을 권장해요.
* 추가 리소스는 **단계적 다운로드(Lazy Loading)** 방식을 적용하면 사용자 경험이 더 좋아져요.

### 2. 검토 요청하기

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

* **테스트를 1회 이상 완료한 경우에만** 검토 요청 버튼이 활성화됩니다.
* 검토 요청은 **한 번에 하나의 버전만** 제출할 수 있어요.

검토 요청 후 수정이 필요한 버그를 발견한 경우에는 **'요청 취소하기'** 버튼을 눌러 검토를 취소한 뒤, 수정된 **새로운 번들(.ait)** 을 업로드하고 다시 검토를 요청하세요.

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

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

'반려사유 보기' 버튼을 눌러 사유를 확인한 뒤, 문제를 해결하여 **새로운 번들을 업로드 후 다시 검토 요청**을 진행해 주세요.

반려 사유에 대해 추가로 문의 사항이 있다면 [채널톡](https://apps-in-toss.channel.io/workflows/787658)으로 문의하실 수 있어요.

<figure><img src="/files/2aW4km3QS6I6RnLagLni" alt=""><figcaption></figcaption></figure>

### 3. 출시하기

번들이 승인되면 **검수 결과가 이메일로 안내**돼요. 이후 콘솔에서 **'출시하기'** 버튼을 클릭하면 미니앱이 사용자에게 공개됩니다.

> ⚠️ **출시 즉시 전체 사용자에게 반영**되므로, 반드시 충분히 테스트한 뒤 출시하세요.

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

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

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

* 메모리/리소스 사용량
* 네트워크 요청(CORS)
  * Origin 허용 목록에 다음 도메인을 등록해야 해요.
    * 실제 서비스 환경: `https://<appName>.apps.tossmini.com`
    * QR 테스트 환경: `https://<appName>.private-apps.tossmini.com`
* 권한 처리
* 로그인/세션 유지
* 실제 결제·인증 기능

> ⚠️ 테스트 환경에서는 정상이어도, 실제 환경에서는 오류가 발생할 수 있어요.
> {% endhint %}

### 4. 출시 후 관리

출시 후에는 앱인토스 콘솔에서 버전 관리와 업데이트를 진행할 수 있어요. 필요에 따라 **새 번들을 업로드**하거나 **기존 버전을 유지·관리**할 수 있습니다.

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

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

> ⚠️ 출시된 버전은 즉시 사용자에게 반영되므로, 사전에 충분한 테스트를 진행한 뒤 업로드하세요.

#### **4-2. 이전 버전 유지 및 롤백**

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

> ⚠️ 롤백 역시 사용자에게 즉시 반영되므로, 버전 선택 시 주의하세요.

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

<figure><img src="/files/I3KrQMhJRc1I8glOHOH5" 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.