# 마켓플레이스 앱 가격 설정하기

Hyperclass 개발자 앱 마켓플레이스에서 앱을 수익화하는 다양한 방법이 있습니다. 이 가이드는 사용 가능한 옵션들을 안내하고 설정 방법을 설명합니다.

***

**목차**

* [앱 가격은 어디서 설정하나요?](#앱-가격은-어디서-설정하나요)
* [결제 수집 방식 선택 (Hyperclass 플랫폼 내부, 권장)](#결제-수집-방식-선택-hyperclass-플랫폼-내부-권장)
* [외부 결제 페이지 (권장하지 않음)](#외부-결제-페이지-권장하지-않음)
* [어떤 가격 모델을 제공할 수 있나요?](#어떤-가격-모델을-제공할-수-있나요)
* [개발자로서 사용하는 방법은?](#개발자로서-사용하는-방법은)
* [에이전시로서 사용하는 방법은?](#에이전시로서-사용하는-방법은)
* [재판매 및 마크업 동작 (에이전시)](#재판매-및-마크업-동작-에이전시)
* [배포 유형 및 가격 모델](#배포-유형-및-가격-모델)
* [무료 체험 제공하기](#무료-체험-제공하기)
* [기억해야 할 주요 사항](#기억해야-할-주요-사항)
* [사용량 기반 가격 책정](#사용량-기반-가격-책정)
* [수익 계산 방식](#수익-계산-방식)
* [수익 대시보드](#수익-대시보드)
* [지급](#지급)
* [자주 묻는 질문](#자주-묻는-질문)

***

## **앱 가격은 어디서 설정하나요?**

[마켓플레이스 - 개발자 계정](https://marketplace.gohighlevel.com/)에 로그인하고, 앱을 클릭한 다음 좌측 메뉴에서 'Pricing(가격)' 옵션을 선택하세요.

![앱 가격 설정 메뉴](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155034622435/original/xppr0jO6LqPc7JuWCYBN4KN_bAw8tnB5Ng.png?1728892235)

***

## **결제 수집 방식 선택 (Hyperclass 플랫폼 내부, 권장)**

이 방식을 사용하면 고객(에이전시와 하위 계정 모두)이 Hyperclass 플랫폼 내에서 앱 비용을 결제할 수 있습니다. 저희가 결제 처리를 담당하고 개발자에게 정시에 지급합니다.

* 에이전시가 이러한 앱을 최종 하위 계정에 재판매할 수 있어, 앱의 더 폭넓은 채택과 참여를 촉진합니다
* 무료 체험 등 Hyperclass 마켓플레이스 플랫폼이 제공하는 세부적인 가격 모듈을 사용할 수 있습니다
* 결제 수집 및 정산이 간소화됩니다

***

## **외부 결제 페이지 (권장하지 않음)**

본인의 플랫폼에서 앱 가격을 직접 관리하려면 이 옵션을 선택하고 외부 결제 페이지의 리다이렉트 URL을 제공하세요. 고객은 설치 과정에서 귀하의 결제 페이지로 이동하게 되며, 결제가 성공하면 계정에 앱이 설치됩니다.

결제 페이지의 리다이렉트 URL을 추가하세요.

참고사항:

* 처음에 외부 결제 페이지를 선택했다면 나중에 Hyperclass 플랫폼으로 변경할 수 있습니다. 하지만 내부 결제 수집으로 운영 중인 경우 외부 페이지로 전환할 수 없습니다. 이런 변경을 위해서는 앱을 삭제하고 다시 생성해야 합니다.
* 에이전시는 외부 결제 방식의 앱을 재판매할 수 없어 앱 채택 기회가 줄어듭니다.

***

## **어떤 가격 모델을 제공할 수 있나요?**

앱은 다음 세 가지 가격 모델 중 하나를 가질 수 있으며, 모두 가격 플랜(Pricing Plans)을 통해 설정 가능합니다:

* 무료
* 유료 - 구독
* 유료 - 일회성
* 프리미엄 - 무료 및 유료 플랜 조합

위 모든 가격 모델에서 선택적으로 무료 체험을 제공할 수 있습니다.

***

## **개발자로서 사용하는 방법은?**

**A) 빌링 미터 설정**

* App(앱) → Pricing(가격) → Billing Meters(빌링 미터)로 이동해서 Module Type = Custom Event (API)로 미터를 생성(또는 편집)합니다.
* Price Type을 Dynamic으로 설정합니다.
* 최소 및 최대 가격을 입력하고, Pricing Page URL을 추가(투명성을 위해 권장)한 다음, 단위당 기본 가격을 설정합니다.
* 변경사항을 저장합니다.

![빌링 미터 설정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155059526643/original/nmVf0EJvUoU0PbD-X8eIrV5hPcXzjBtr2Q.png?1764452995)

**B) API를 통한 월렛 차지**

* 기존의 [월렛 차지 생성 API](https://marketplace.gohighlevel.com/docs/ghl/marketplace/charge)를 사용합니다. 해당 차지에 동적 단위당 가격을 적용하려면 새로운 선택적 price 필드를 포함시키세요.
* price가 생략되면 미터의 단위당 기본 가격이 적용됩니다.

***

## **에이전시로서 사용하는 방법은?**

* 앱의 가격 섹션에서 최종 사용자는 동적 미터의 가격 범위와 가격 페이지 URL 링크를 볼 수 있습니다.
* **표시 참고사항**: 가격 페이지 URL은 에이전시 관리자에게만 표시되며, 하위 계정에는 표시되지 않습니다.

![에이전시 가격 표시](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155059526677/original/9gvj0eyVVzq4GNTd2fNZb-C20RIZyxma6g.png?1764453310)

***

## **재판매 및 마크업 동작 (에이전시)**

* 에이전시는 앱 서비스 재판매 시 단위당 고정 마크업을 설정할 수 있습니다.
* 마크업으로 인해 최종 가격이 변경되므로, 혼란을 방지하기 위해 하위 계정에서는 가격 페이지 URL이 숨겨집니다.
* 예시: SMS 기본 가격이 $1.00(영국), $1.50(프랑스)인 경우, 에이전시가 $0.50 마크업을 추가하면 하위 계정은 $1.50(영국), $2.00(프랑스)를 지불합니다.

![에이전시 마크업 설정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155059526690/original/aqMQVwqhOu3K2FAyWm_D72UFuNyeitDvzg.png?1764453401)

***

## **배포 유형 및 가격 모델**

배포 유형을 이해하려면 [**이 아티클을 참고하세요**](/hyperclass-docs/developer/marketplace-app-distribution-type.md).

이 섹션에서는 누구에게 요금을 부과할지에 따라 배포 유형을 어떻게 커스터마이징할 수 있는지 알아보겠습니다.

다음 예시에서 에이전시가 모든 마켓플레이스 앱에 대해 고정 5% 마크업을 설정했다고 가정합니다.

| 배포 모델                                                              | 앱 가격 모델 (예시)                   | 에이전시 지불                  | 하위 계정이 에이전시에 지불 | 개발자 수익                   |
| ------------------------------------------------------------------ | ------------------------------ | ------------------------ | --------------- | ------------------------ |
| Target User: Agency                                                | 월간: $50/월                      | $50/월                    | -               | $50/월                    |
|                                                                    | 일회성: $50                       | $50 일회성                  | -               | $50 일회성                  |
| Target User: Sub-account \| Who can install?: Agency & Sub-account | 월간: $10/월                      | $10/월                    | $10.5/월         | $10/월                    |
|                                                                    | 일회성: $10                       | $10 일회성                  | $10.5 일회성       | $10 일회성                  |
| Target User: Sub-account \| Who can install?: Agency Only          | 월간: $50/월                      | $50/월                    | -               | $50/월                    |
|                                                                    | 일회성: $50                       | $50 일회성                  | -               | $50 일회성                  |
| 차등 가격 활성화 (월간)                                                     | 에이전시 가격: $50/월 하위 계정 가격: $10/월 | $50/월 + 하위 계정당 $10/월     | $10.5/월         | $50/월 + 하위 계정당 $10/월     |
| 차등 가격 활성화 (일회성)                                                    | 에이전시 가격: $50 하위 계정 가격: $10     | $50 일회성 + 하위 계정당 $10 일회성 | $10.5 일회성       | $50 일회성 + 하위 계정당 $10 일회성 |

Target User: Sub-account | Who can install?: Agency Only인 앱의 차등 가격 설정 방법:

![차등 가격 설정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155034686628/original/mS_pY98lXhO1D7j7bF6F8mqCrHdO73QlDQ.jpeg?1728959419)

***

## **무료 체험 제공하기**

제한된 기간 동안 앱의 전체 경험을 제공하는 무료 체험으로 앱 채택을 촉진하세요.

사용자에게 1-90일 사이의 무료 체험을 제공할 수 있습니다.

![무료 체험 설정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155030099991/original/hIs1ghkZosk4Ne8nnEWigzGTJZ-RgcSo_g.png?1722327989)

체험 기간이 끝나면 구독이 자동으로 시작됩니다.

![무료 체험 자동 시작](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155030100131/original/mqhcRPfmMCy3Mc65safT30BwLlJ67uS2OA.png?1722328082)

***

## **기억해야 할 주요 사항**

* 무료 체험 설정은 앱 레벨에서 이루어지며, 앱의 모든 가격 플랜에 적용됩니다.
* 사용자는 90일 기간 내에 앱당 한 번만 무료 체험을 이용할 수 있습니다.
* 체험 기간이 끝나기 24시간 전에 사용자는 예정된 요금에 대한 알림을 받습니다.
* 무료 체험 후 결제 실패 시, Hyperclass가 사용자에게 알리고 3일 연속 재시도합니다. 3일 연속 결제 실패 후 사용자 계정에서 앱이 제거됩니다.
* [AppInstall 웹훅](https://highlevel.stoplight.io/docs/integrations/889f37581bd0e-o-auth-2-0)과 [설치된 로케이션 가져오기 API](https://highlevel.stoplight.io/docs/integrations/aeed19d08490e-get-location-where-app-is-installed)를 통해 무료 체험 기간을 추적할 수 있습니다.

***

## **사용량 기반 가격 책정**

가격이 변동될 수 있는 서비스가 앱에 있다면 동적 가격 옵션을 선택할 수 있습니다.

**중요**: [사용량 기반 가격 책정 API 문서 링크](https://marketplace.gohighlevel.com/docs/ghl/marketplace/wallet-charges)를 참고하세요.

***

## **수익 계산 방식**

Hyperclass 플랫폼의 앱 설치로부터 수익이 발생합니다. 현재 저희는 수수료를 공제하지 않습니다. 고객 결제 전액을 받습니다. 하지만 에이전시가 하위 계정에 재판매할 때 가격을 마크업할 수 있습니다. 예를 들어:

하위 계정 앱 가격이 다음과 같다고 가정합니다:

* 개발자 가격: $10/월
* 에이전시 재판매 가격: $12/월

하위 계정이 앱을 설치할 때 결과적인 거래는 다음과 같습니다:

* 하위 계정 청구: $12/월
* 에이전시 청구: $10/월
* 개발자 수익: $10/월

***

## **수익 대시보드**

'수익 대시보드(Earnings Dashboard)'에서 수익을 추적하세요. 라이브 유료 앱의 경우:

* 총 수익: 현재까지 누적 수익
* 총 설치: 앱 설치 수
* 활성 계정: 현재 활성/설치된 계정 수
* 자세한 정보를 위해 아래 표를 사용하고 필요에 따라 필터를 적용하세요.

![수익 대시보드](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155010503781/original/5iwskODmD8lq09A6MWsLX3qzs2iJB7TQIQ.png?1697694564)

***

## **지급**

개발자 지급을 원활하게 처리하기 위해 Tipalti와 파트너십을 맺어 원활하고 효율적인 거래 프로세스를 제공합니다.

### **지급 프로세스는 어떻게 작동하나요?**

* 지급 자격이 있는 개발자 파트너는 Tipalti 등록을 위한 이메일 초대를 받게 됩니다. 이 3단계 등록 프로세스는 규정 준수와 지급 수신에 필요한 모든 사항을 안내합니다.
* 계정이 설정되고 준비되면 Hyperclass로부터 지급을 받기 시작합니다. 청구 주기는 월간이며, 전월에 발생한 모든 수익에 대해 매월 15일에 지급됩니다.

이미 Tipalti를 설정하고 지급 상태가 "submitted"로 표시되어 있다면 지급이 진행 중입니다. 선택한 지급 방법에 따라 1-3일 내에 지급을 받을 수 있습니다.

자세한 작동 방식은 [Tipalti 지급 프로세스](https://github.com/benjaminhyperclass/hyperclass-help-ko/blob/main/docs/21-어필리에이트/Affiliates-Program/affiliate-payouts-where-how-when-can-i-get-paid-.md)를 참고하세요.

***

## **자주 묻는 질문**

**Q: API의 새로운 "price" 매개변수의 목적은 무엇인가요?** A: 개발자가 청구 이벤트 중에 동적 단위당 요금을 설정할 수 있게 하여, 가격이 현재의 가변적인 서비스 비용을 반영할 수 있도록 합니다.

**Q: API 호출에서 "price" 매개변수를 생략하면 어떻게 되나요?** A: 시스템이 빌링 미터에 이전에 설정된 단위당 기본 가격을 기본값으로 사용합니다.

**Q: 에이전시는 동적 가격 책정으로 어떤 이점을 얻나요?** A: 에이전시는 동적 가격 책정을 사용하여 명확한 가격 범위를 표시하고 서비스에 고정 마크업을 설정하여 하위 계정에 투명하고 경쟁력 있는 가격을 제공할 수 있습니다.

**Q: 가격 페이지 URL을 누가 볼 수 있나요?** A: 가격 페이지 URL은 에이전시 관리자에게만 표시되어 가격 세부사항을 명확하게 하고 하위 계정 간 혼란을 방지합니다.

**Q: SMS 외의 서비스에도 동적 가격 책정을 적용할 수 있나요?** A: 네, 동적 가격 책정은 비용이 변동하는 모든 서비스에 이상적이며, 전화 서비스 및 기타 지역 기반 API를 포함합니다.

**Q: 동적 빌링 미터 설정에는 어떤 단계가 필요한가요?** A: Hyperclass에서 가격 유형을 Dynamic으로 선택하고, 가격 제한과 가격 페이지 URL을 입력한 다음, 선택적 "price" 매개변수가 포함된 업데이트된 API를 연동하여 미터를 설정해야 합니다.

***

*원문 최종 수정: Sat, 29 Nov, 2025 at 3:57 PM* *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/miscellaneous/set-up-your-app-pricing.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.