# 에이전시 앱 재판매 설정 API

새로운 에이전시 앱 재판매 설정 API를 사용하여 커스텀 요금제 카드, 페이월, 또는 결제 플로우에서 에이전시의 마크업된 앱 가격을 쉽게 표시할 수 있습니다. HighLevel이 각 하위 계정에 대해 저장하는 정확한 재청구 설정을 가져와서, 고객이 판매하는 곳에 관계없이 항상 올바른 화이트라벨 가격을 볼 수 있도록 보장합니다.

***

**목차**

* [에이전시 앱 재판매 설정 API란?](#에이전시-앱-재판매-설정-api란)
* [에이전시 앱 재판매 설정 API의 주요 장점](#에이전시-앱-재판매-설정-api의-주요-장점)
* [인증 요구사항](#인증-요구사항)
* [핵심 포인트](#핵심-포인트)
* [응답 객체 및 가격 유형](#응답-객체-및-가격-유형)
* [가격 표시 모범 사례](#가격-표시-모범-사례)
* [자주 묻는 질문](#자주-묻는-질문)

***

## **에이전시 앱 재판매 설정 API란?**

에이전시 앱 재판매 설정 API(기술적으로는 Get Rebilling Config for App 엔드포인트)는 특정 앱에 대해 에이전시가 설정한 최종 고객 대상 가격을 반환하는 마켓플레이스 개발자용 REST 엔드포인트입니다. 하위 계정 OAuth 토큰으로 호출하면, API는 모든 활성 구독, 일회성, 사용량 기반 요금을 응답하여 마켓플레이스와 에이전시의 내부 청구 규칙에 일치하는 가격을 렌더링할 수 있습니다.

![Agency App 재판매 설정 API 개요](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155060766936/original/X2hgGWeK5Y-K7B6RHJ5z1TLVbZO6FkL51Q.png?1765918492)

***

## **에이진시 앱 재판매 설정 API의 주요 장점**

* 커스텀 UI와 HighLevel 네이티브 마켓플레이스 간의 가격 불일치를 방지합니다.
* 내부 비용 가격을 보호합니다—에이전시의 업셀 가격만 반환됩니다.
* 단일 호출로 모든 청구 모델(구독, 일회성, 사용량 기반)을 지원합니다.
* 결제 플로우를 화이트라벨로 유지합니다—하위 계정은 HighLevel 브랜딩을 볼 수 없습니다.
* 유지보수를 간소화합니다—더 이상 플랜 ID나 마크업을 하드코딩할 필요가 없습니다.

***

## **인증 요구사항**

가격은 에이전시와 고객에 따라 달라질 수 있으므로 유효한 하위 계정(로케이션) 액세스 토큰이 필요합니다. 에이전시나 개발자 토큰으로 엔드포인트를 호출하면 403 Forbidden이 반환됩니다.

***

## 핵심 포인트

* OAuth-2.0 Authorization Code 또는 Refresh-Token 플로우
* 토큰 스코프에 [marketplace.app.read](https://marketplace.gohighlevel.com/docs/ghl/marketplace/get-rebilling-config-for-app/index.html)가 포함되어야 합니다.
* 속도 제한: 앱당 분당 60회 요청 (변경될 수 있음)

***

## **응답 객체 및 가격 유형**

JSON 응답은 subscriptionPlans, oneTimePlans, usageMeters 네임스페이스로 구성되며, 각 배열에는 planId, planName, currency, price, billingInterval이 포함됩니다. 이러한 필드를 사용하여 다음과 같은 동적 UI 요소를 구축할 수 있습니다:

* 월간/연간 토글 버튼 (billingInterval 사용)
* 사용량 계층 차트 (포함된 단위 및 초과 요금 사용)
* 기간 한정 오퍼 (planName 또는 메타데이터 태그 사용)

***

## **가격 표시 모범 사례**

신뢰를 구축하고 장바구니 이탈을 줄이기 위해:

* 사용자가 플랜 수량이나 청구 주기를 변경할 때 실시간으로 가격을 새로고침합니다.
* 오래된 데이터 표시 없이 API 호출을 최소화하기 위해 5-10분간 응답을 캐시합니다.
* 모호함을 피하기 위해 통화와 청구 간격을 명확히 라벨링합니다.
* 완전한 화이트라벨 경험을 유지하기 위해 에이전시 색상과 타이포그래피를 사용합니다.
* 에이전시가 플랜을 제거하거나 가격을 0으로 설정하는 엣지 케이스를 테스트합니다.

***

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

**Q: API가 에이전시의 기본 통화로 가격을 반환하나요?**

네. 각 객체에는 currency 필드가 포함되어 있어 올바른 기호를 표시할 수 있습니다.

**Q: 에이전시가 하위 계정에 대해 재청구를 활성화하지 않은 경우 어떻게 되나요?**

엔드포인트는 여전히 응답하지만, 가격 값은 기본 마켓플레이스 비용(마크업 없음)과 동일합니다.

**Q: 얼마나 자주 가격을 새로고침해야 하나요?**

모범 사례는 페이지 로드 시와 고객이 플랜 옵션을 변경할 때이며, 속도 제한을 준수하기 위해 5-10분의 서버 사이드 캐싱을 사용하는 것입니다.

**Q: 이 API를 에이전시 레벨 토큰으로 호출할 수 있나요?**

아니요. 하위 계정 토큰을 사용해야 하며, 에이전시 토큰은 403 Forbidden을 받게 됩니다. ([marketplace.gohighlevel.com](https://marketplace.gohighlevel.com/docs/ghl/marketplace/get-rebilling-config-for-app/index.html))

**Q: 응답에 쿠폰이나 프로모션 할인이 포함되나요?**

현재로서는 포함되지 않습니다. 할인은 자체 로직에서 계산하고 표시해야 합니다.

**Q: 엔드포인트에 속도 제한이 있나요?**

네—현재 앱당 분당 60회 요청입니다(변경될 수 있음). 429 응답은 제한을 초과했음을 의미합니다.

***

*원문 최종 수정: 2025년 12월 16일 오후 2:58* *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/developer/agency-app-reselling-config-api.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.