# 앱 마켓플레이스의 사용량 기반 요금제

Hyperclass의 앱 마켓플레이스(App Marketplace)는 사용량 기반 요금제를 지원합니다. 개발자는 실행 횟수, 메시지 수, 커스텀 이벤트별로 요금을 책정할 수 있고, 에이전시는 마크업을 추가하고 일일 사용 한도를 설정할 수 있습니다. 이 가이드에서는 사용량 기반 요금 모델이 무엇인지, 요금 모듈이 어떻게 작동하는지, 마크업과 한도, 요금 청구 흐름을 설정하는 방법을 설명합니다. 역할별 간단한 단계를 따라 자신감 있게 출시하고 고객 청구를 투명하게 관리하세요.

***

**목차**

* [마켓플레이스 사용량 기반 요금제와 에이전시 재청구란?](#마켓플레이스-사용량-기반-요금제와-에이전시-재청구란)
* [마켓플레이스 사용량 기반 요금제와 에이전시 재청구의 주요 장점](#마켓플레이스-사용량-기반-요금제와-에이전시-재청구의-주요-장점)
* [사용량 기반 요금제 모듈](#사용량-기반-요금제-모듈)
* [마켓플레이스 액션 및 트리거의 실행당 요금](#마켓플레이스-액션-및-트리거의-실행당-요금)
* [대화 프로바이더의 메시지당 요금](#대화-프로바이더의-메시지당-요금)
* [앱별 이벤트의 커스텀 사용량 요금](#앱별-이벤트의-커스텀-사용량-요금)
* [청구 제어 및 보호 기능](#청구-제어-및-보호-기능)
* [마켓플레이스 사용량 기반 요금제와 에이전시 재청구 설정 방법](#마켓플레이스-사용량-기반-요금제와-에이전시-재청구-설정-방법)
* [자주 묻는 질문](#자주-묻는-질문)

***

## 마켓플레이스 사용량 기반 요금제와 에이전시 재청구란?

사용량 기반 요금제는 앱 활동에 따라 직접 요금을 부과하므로, 고정 구독료가 아닌 실제 사용량에 따라 비용이 조정됩니다. 에이전시 재청구는 에이전시가 자체 마크업을 추가하여 사용량별 요금을 재판매할 수 있게 해주므로, 고객 청구를 중앙화하면서 수익 마진을 유지할 수 있습니다.

사용량 기반 요금제는 세 가지 모듈을 지원합니다: 액션/트리거의 실행당 요금, 대화 프로바이더(Conversation Provider)의 메시지당 요금(인바운드와 아웃바운드 요금 분리), 마켓플레이스 결제 API를 통해 게시되는 앱 정의 이벤트의 커스텀 사용량 요금입니다. 에이전시 재청구는 이러한 사용량별 요금에 에이전시가 설정한 마크업을 적용하고, 재청구 설정에 따라 적절한 지갑(wallet)에서 요금을 청구합니다.

***

## 마켓플레이스 사용량 기반 요금제와 에이전시 재청구의 주요 장점

소비 기반 청구가 언제 적합한지, 예산과 마진을 어떻게 보호할지 결정하는 데 도움이 되는 장점들을 알아보세요.

* **비용 일치**: 고정 요금제 대신 실제 활동을 추적하여 요금 부과
* **세밀한 제어**: 실행당, 메시지당(인바운드/아웃바운드), 커스텀 이벤트 중 선택 가능
* **에이전시 마진**: **마크업 제어**로 에이전시가 개발자 요금에 수익을 추가 가능
* **지출 보호**: **일일 사용 한도**로 소비량을 제한하여 청구서 쇼크 방지
* **청구 명확성**: **지갑 청구 흐름**으로 재청구 활성화/비활성화 시 누가 청구되는지 명확히 구분

***

## 사용량 기반 요금제 모듈

앱 개발자는 이제 마켓플레이스 앱에 사용량별 가격을 설정할 수 있습니다. 앱은 세 가지 모듈에 대해 사용량 기반 가격을 설정할 수 있습니다:

### 마켓플레이스 액션 및 트리거의 실행당 요금

액션이나 트리거가 실행될 때마다 요금을 부과하는 방식으로, 워크플로우 중심이나 자동화 중심 앱에 적합합니다.

* **단위**: 지원되는 액션 또는 트리거의 각 실행
* **일반적 용도**: 프리미엄 액션, 데이터 보강, 동기화 단계
* **설정 위치**: App → Pricing → **Actions & Triggers** 활성화 후 실행당 가격 설정

### 대화 프로바이더의 메시지당 요금

메시징 비용은 방향과 채널에 따라 달라질 수 있습니다. 인바운드와 아웃바운드 요금을 분리하여 실제 전송 및 처리 비용에 맞는 요금을 유지할 수 있습니다.

* **단위**: 대화 프로바이더(Conversation Provider)가 처리하는 각 메시지
* **방향별 요금**: **인바운드**와 **아웃바운드** 가격을 별도로 설정
* **설정 위치**: App → Pricing → **Conversation Provider** 요금 필드

### 앱별 이벤트의 커스텀 사용량 요금

분, 토큰 또는 기타 단위와 같은 고유한 이벤트에 대해 자체 이벤트를 정의하고 결제 API를 통해 사용량을 게시하여 청구합니다.

* **단위 예시**: 분당(예: AI 음성), 토큰당, 스캔된 항목당
* **설정 위치**: App → Pricing → **Custom Event (API‑billed)** 및 가격/단위 정의; 결제 API를 통해 사용량 게시
* **검증**: 실제 운영 전 테스트 사용량을 게시하고 요금이 나타나는지 확인

***

## 청구 제어 및 보호 기능

마크업, 청구 흐름, 사용 한도를 요약한 간단한 표로 설정과 정산을 빠르게 처리할 수 있습니다.

| 항목       | 기능                   | 설정 위치                                             | 청구 영향                            | 주요 참고사항               |
| -------- | -------------------- | ------------------------------------------------- | -------------------------------- | --------------------- |
| 에이전시 마크업 | 개발자 사용량 요금에 마진 추가    | App Marketplace → **App Reselling** (Usage‑Based) | 클라이언트에게 청구되는 단위 가격 증가(재청구 ON일 때) | 앱 수준 설정; 클라이언트별 설정 아님 |
| 재청구 ON   | 클라이언트의 하위 계정 지갑에서 청구 | 에이전시 결제 설정(**Rebilling**)                         | 사용량 요금이 하위 계정 지갑에서 차감            | 지갑에 자금이 있는지 확인        |
| 재청구 OFF  | 에이전시 지갑에서 청구         | 에이전시 결제 설정(**Rebilling**)                         | 사용량 요금이 에이전시 지갑에서 차감             | 에이전시 지갑 잔액 모니터링       |
| 일일 사용 한도 | 앱당 일일 청구 가능 단위 제한    | App Marketplace → **Usage Limits**                | 한도 도달 시 사용량 일시정지; 다음 날 재개        | 예산/볼륨에 맞게 한도 설정       |

***

## 마켓플레이스 사용량 기반 요금제와 에이전시 재청구 설정 방법

올바른 설정을 통해 정확한 요금, 사용량 이벤트의 정확한 게시, 예측 가능한 고객 청구를 보장할 수 있습니다.

1. **App Marketplace**로 이동 → 앱 열기 → **App Reselling** (Usage‑Based) 클릭
2. **Set Usage‑Based Pricing**(또는 동등한 옵션) 선택 후 **마크업** 입력; 저장
3. **App Marketplace** → **Usage Limits**로 이동하여 클라이언트/하위 계정당 일일 한도 설정; 저장
4. 적격 요금이 하위 계정 지갑에서 차감되도록 **Rebilling** 활성화 확인

![에이전시 재청구 설정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155058417770/original/Wip_LlMcsLfo9IZwF9GmHTH2vJmrWemgAg.gif?1763131962)

**앱의 사용량 기반 요금은 어디서 볼 수 있나요?**

앱에 사용량 기반 요금이 있는 경우, 요금 세부 정보가 앱 상세 페이지의 Pricing 섹션에 표시됩니다.

![앱 상세 페이지 요금 정보](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155058419128/original/9OhgC36ejur0KDG_2bZTgfM-Nv9JQiTTPQ.png?1763132367)

워크플로우 액션(Workflow Actions)과 트리거(Triggers)의 경우, 사용량 요금이 워크플로우 빌더의 Discover 탭에도 표시됩니다.

![워크플로우 빌더 Discover 탭 요금 정보](https://s3.amazonaws.com/cdn.freshdesk.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155058419243/original/zKnvrkqQFZ5EOK-VuYp0DdbNvfTjszAHMA.png?1763132394)

***

## 자주 묻는 질문

**Q: 재청구가 켜져있을 때와 꺼져있을 때 누구에게 청구되나요?** 재청구가 켜져있을 때는 하위 계정 지갑에서 청구됩니다. 꺼져있을 때는 에이전시 지갑에서 청구됩니다.

**Q: 인바운드와 아웃바운드 메시지 가격을 다르게 설정할 수 있나요?** 네. 대화 프로바이더는 인바운드와 아웃바운드 메시지별 요금을 분리하여 지원합니다.

**Q: 마크업은 앱별로 설정하나요, 클라이언트별로 설정하나요?** 마크업은 사용량 기반 앱의 앱 수준에서 설정됩니다. 클라이언트는 에이전시 가격만 봅니다.

**Q: 일일 한도에 도달하면 어떻게 되나요?** 해당 앱의 청구 가능 사용량이 하루 남은 시간 동안 일시정지되고, 일일 리셋 후 재개됩니다.

**Q: 구독과 사용량 요금을 함께 사용할 수 있나요?** 네. 앱에서 지원하는 경우 액세스는 구독으로, 소비는 사용량 기반 요금으로 사용할 수 있습니다.

**Q: 클라이언트에게 배포하기 전에 어떻게 테스트하나요?** 개발자는 결제 API를 통해 테스트 사용량을 게시할 수 있고, 에이전시는 마크업 및 한도 화면에서 요금과 한도 동작을 확인할 수 있습니다.

**Q: 사용량 기반 요금은 어디서 확인하나요?** 관련 앱 마켓플레이스 뷰와 지갑에서 요금을 검토할 수 있습니다. 일부 사용량은 모듈에 따라 앱이 발견되는 곳(예: 워크플로우 Discover)에서도 볼 수 있을 수 있습니다.

***

*원문 최종 수정: Fri, 14 Nov, 2025 at 9:17 AM* *Hyperclass 사용 가이드 — hyperclass.ai*


---

# Agent Instructions: 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:

```
GET https://hyperclass.gitbook.io/hyperclass-docs/app-marketplace/usage-based-pricing-on-app-markeptlace.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.