요율표 요금제 구성

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

소개

요율표 요금제에서는 각 거래에 대해 개발자에게 요금이 청구됩니다. 이 유형의 요금제의 경우 청구 모델 및 청구 모델의 가격과 같은 추가 세부정보를 제공해야 합니다.

선택적으로 API 패키지가 아닌 개별 제품에 부분 유료 모델 요금제를 지정할 수 있으며 이 작업은 제품별 요금제에만 지정할 수 있습니다.

언제 반복 수수료가 청구되고 번들 요금제가 재설정되나요?

요금제에는 반복 요금과 API 번들 (볼륨 단위 및 번들 요금제)이 포함될 수 있습니다. 두 요금제 모두 수수료가 청구되고 번들 요금제가 0으로 재설정되는 특정 시점과 관련이 있습니다. 다음 표에서는 반복 수수료가 청구되고 번들 수가 재설정되는 경우를 설명합니다. 특정 트랜잭션 한도에 도달하여 개발자 앱이 추가 API 호출을 할 수 없는 경우, 이 때 API 호출 수가 0으로 재설정되고 앱이 다시 호출을 시작할 수 있습니다.

요금제에... 다음과 같은 결과가 발생합니다.
  • 0이 아닌 반복 수수료가 로 설정됨
  • Volume Banded 또는 Bundle 요금제

반복 수수료 및 번들 요금제 재설정은 매월 1일에 발생합니다 (기본값).

특정 날짜에 매달 반복하려면 API를 사용하여 요금제 만들기에 설명된 대로 관리 API를 사용하여 요금제를 만들고 RecurringStartUnit 속성을 사용하여 날짜를 표시합니다.

  • 0이 아닌 반복 수수료가 로 설정됨
  • Volume Banded 또는 Bundle 요금제
반복 수수료 및 번들 요금제 재설정은 개발자의 요금제 시작일로부터 7일마다 이루어집니다.
  • 0이 아닌 반복 수수료를 로 설정
  • Volume Banded 또는 Bundle 요금제
반복 수수료 및 번들 요금제 재설정은 개발자의 요금제 시작일로부터 X일마다 이루어집니다.
  • 반복 수수료 없음 (또는 무료)
  • Volume Banded 또는 Bundle 요금제

번들 요금제는 요율표에 정의된 집계 기준에 따라 재설정됩니다. 예를 들어 개발자가 매월 19일에 요금제를 시작하고 집계 기준이 1개월인 경우 번들 사용량은 매월 19일에 재설정됩니다.

한 달 중 날짜가 항상 동일하지는 않을 수도 있습니다. 예를 들어 요금제가 12월 31일에 시작하는 경우 2월에는 28일만 있으므로 윤년이 아닌 해의 2월에는 재설정 날짜가 28일이 됩니다. 그러면 28일은 이후 재설정 날로 유지됩니다.

UI를 사용하여 요율표 요금제 구성

아래에 설명된 대로 요율표 요금제를 구성합니다.

에지

요율표 요금제를 구성하려면 요금제를 만들거나 수정할 때 요율표요율표 및 수익 공유 요금제 유형을 선택하고 요율표 섹션에서 다음 청구 모델 중 하나를 선택합니다.

충전 모델 설명
정액제 개발자에게는 거래 건당 고정 요금이 청구됩니다.
볼륨 밴드 개발자에게는 거래량에 따라 가변 세율이 청구됩니다.
Bundles 개발자에게는 각 거래 번들에 대해 설정된 금액이 선불로 청구됩니다. 번들 전체 사용 여부와 관계없이 개발자에게 설정된 금액이 청구됩니다.

참고: 요율표 및 수익 공유를 선택하는 경우에는 이 옵션을 사용할 수 없습니다.

그런 다음 선택한 충전 모델에 따라 다음 정보를 구성합니다.

충전 모델 필드 설명
전체 계산 빈도 거래량 (또는 맞춤 속성 관련 수량)을 계산하는 기간입니다. 개월 수 (1~24개월)를 선택합니다.
정액제 균일 운임 각 거래에 청구되는 요율입니다. 십진수를 입력합니다 (소수점 이하 최대 4자리).

참고: UI가 아닌 API를 사용하여 청구되는 요율에 대해 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요금의 소수점 이하 자릿수 구성을 참고하세요.

예를 들어 0.10을 입력하고 통화가 미국 달러인 경우 개발자에게는 거래 건당 0.10달러가 청구됩니다. 또는 트랜잭션에서 전송된 바이트 수와 같은 사용자 지정 속성을 기준으로 한 경우에는 지정된 바이트 수 전송에 대해 개발자에게 0.10달러가 청구됩니다.

볼륨 밴드 볼륨 밴드 볼륨 밴드 충전 모델에 적용되는 하나 이상의 거래 (또는 고객 속성 기반) 볼륨 범위 (각 범위는 '볼륨 밴드')입니다. 각 볼륨 밴드에는 요율을 할당할 수 있습니다. 요율은 해당 볼륨 대역 내의 모든 거래에 적용됩니다. 첫 번째 대역의 상한값을 지정합니다(예: 최대 1,000개(하한은 0보다 크게 미리 설정됨).

+새 밴드를 클릭하여 밴드를 추가합니다.

이 수준을 초과하는 모든 거래를 나타내려면 최종 대역의 상한선을 비워 둡니다.

참고: UI가 아닌 API를 사용하여 청구되는 요율에 대해 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요금의 소수점 이하 자릿수 구성을 참고하세요.

예를 들어, 볼륨 밴드 섹션에서 두 개의 볼륨 밴드를 지정하는 경우(0-1000 이상 및 1000 이상), 0-1000 이상의 볼륨 밴드에 대해서는 0.15를, 1000 이상의 볼륨 밴드에 대해서는 0.10을 입력할 수 있습니다. 선택한 통화가 미국 달러인 경우 첫 1, 000건의 거래는 거래 건당 $0.15는 거래당 $0.15이며, 거래 1, 000건 이상은 거래당 $0.10입니다.

Bundles API 번들 가격 번들에 포함된 트랜잭션 수 (또는 번들에서 전송된 총 바이트 수와 같은 커스텀 속성과 관련된 수)입니다. 각 번들에 가격을 할당할 수 있습니다. 가격은 전체 번들에 적용됩니다. 첫 번째 번들의 상한값을 지정합니다(예: 최대 1,000개(하한은 0보다 크게 미리 설정됨).

+새로 만들기를 클릭하여 번들을 추가합니다. 마지막 번들의 무제한 거래에 대해 개발자에게 고정 금액을 청구하려는 경우가 아니면 마지막 번들의 상한값을 지정해야 합니다.

참고: UI가 아닌 API를 사용하여 청구되는 요율에 대해 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요금의 소수점 이하 자릿수 구성을 참고하세요.

예를 들어 번들 크기 섹션에서 두 개의 번들 (0~1,000, 1,000~2,000)을 지정하는 경우 0~1000인 번들에는 50을, 1,000~2,000인 번들에는 40을 입력할 수 있습니다. 선택한 통화가 미국 달러인 경우 첫 번째 번들의 가격은 50달러이고 두 번째 번들의 가격은 40달러입니다. 개발자는 번들 내에서 사용하는 거래 수와 관계없이 해당 번들 가격이 청구됩니다. 즉, 번들의 첫 번째 거래가 완료되는 즉시 개발자에게 번들 가격이 청구됩니다.

API 제품에 대한 맞춤 속성을 정의한 경우 각 거래 내의 맞춤 속성에 따라 앱 개발자에게 청구하도록 맞춤 평점 매개변수를 구성할 수 있습니다. 예를 들어 각 트랜잭션에 대해 개발자에게 청구하는 요금제를 설정하는 경우 커스텀 속성(예: 트랜잭션별로 다를 수 있는 백엔드에서 전송되는 바이트 수)을 기반으로 요금제의 요금을 설정할 수 있습니다.

이 경우 맞춤 평점 매개변수 사용을 선택하고 드롭다운 목록에서 맞춤 속성을 선택합니다. 자세한 내용은 맞춤 속성을 사용하여 요금제 구성을 참고하세요.

Classic Edge (Private Cloud)

기본 Edge UI를 사용하여 요율표 요금제를 구성하려면 다음 안내를 따르세요.

  1. 단계에 따라 요금제를 만듭니다.
  2. 요금제 유형 드롭다운에서 요율표를 선택하여 수익 모델을 구성합니다.
  3. 선택한 API 패키지에 여러 API 제품이 포함된 경우 다음 옵션 중 하나를 선택합니다.

    참고: API 패키지에 단일 API 제품이 포함된 경우 이 단계를 건너뛸 수 있습니다.

    • 제품별 요금제: 각 API 제품의 요금제 세부정보를 개별적으로 구성합니다.
    • 모든 제품에 대한 일반 요금제를 사용하여 모든 API 제품의 요금제 세부정보를 구성합니다.
  4. 일반 요금제 또는 각 API 제품별 요금제의 경우 요율표를 클릭합니다.

    참고: API 제품별 요금제를 구성할 때 각 API 제품의 요율표 요금제를 개별적으로 구성해야 합니다.

    요율표 창이 열립니다.

  5. API 제품의 부분 유료 모델 요금제를 설정합니다. 부분 유료 모델 요금제를 통해 개발자는 일정 기간 동안 또는 사용량에 따라 API 제품을 무료로 사용할 수 있습니다.

    다음 정보를 입력합니다.

    필드 설명
    부분 유료화(Freemium) 제품인가요?

    무료 기간의 범위입니다. 다음 라디오 버튼 중 하나를 선택합니다.

    • 수량 기준. 무료 기간은 Volume(볼륨) 필드에 지정된 수량을 기반으로 합니다.
    • 기간별. 수수료 기간은 부분 유료화 기간 필드에 지정된 시간 간격을 기준으로 합니다.
    • 어느 쪽이든 먼저 충족 볼륨 필드의 수량 또는 부분 유료 기간 필드의 시간 간격에 도달하면 무료 기간이 종료됩니다(둘 중 먼저 발생하는 것).
    • 아니요. 부분 유료화 요금제가 아닙니다. 이는 기본값입니다.
    부분 유료화(Freemium) 볼륨

    개발자에게 청구되지 않는 거래량 (또는 거래 기록 정책에 기록된 맞춤 속성과 관련된 수량)입니다. 볼륨은 API 제품에 대해 측정됩니다. 볼륨 번호(예: 5000)를 입력합니다. 즉, 개발자가 요금제를 시작할 때 처음 5,000건의 거래(또는 맞춤 속성 관련 항목을 처음 5,000회 사용하는 경우)에 대해서는 요금이 청구되지 않습니다. 이 필드는 '부분 유료 제품' 필드에서 '수량별' 또는 '둘 중 먼저 발생하는 것'을 선택한 경우에만 사용 설정됩니다.

    부분 유료화 기간

    개발자에게 요금이 청구되지 않는 시간 간격입니다. 숫자를 입력하고 기간(예: 1개월)을 선택합니다. 즉, 개발자에게 1개월 요금이 청구되지 않습니다. 이 필드는 '부분 유료 제품(Freemium Product)' 필드에서 '기간 기준' 또는 '둘 중 먼저 발생하는 것'을 선택한 경우에만 사용 설정됩니다.

  6. 다음 충전 모델 중 하나를 선택합니다.
    • 고정 요금. 이 모델에서는 개발자에게 각 트랜잭션에 대해 고정 요금이 청구됩니다.
    • 볼륨 밴드 이 모델에서는 거래량에 따라 개발자에게 가변 요금이 청구됩니다.
    • 번들. 이 모델에서는 각 거래 번들에 대해 개발자에게 설정된 금액 (선불)이 청구됩니다. 번들 전체 사용 여부와 관계없이 개발자에게 설정된 금액이 청구됩니다.

    고정 요금 모델의 경우: 일반 요율표 창의 가격 책정 섹션에 다음 정보를 입력합니다.

    필드 설명
    운영자 (또는 조직)

    조직 이름입니다. 이 필드는 조직 프로필의 연산자 (또는 조직) 필드 값을 사용하여 미리 설정됩니다.

    국가

    조직이 운영되는 국가입니다. 이 필드는 조직 프로필의 국가 필드 값을 사용하여 미리 설정됩니다.

    정액제

    각 거래에 청구되는 요율입니다. 십진수를 입력하세요 (소수점 이하 최대 4자리).

    참고: UI가 아닌 API를 사용하여 청구되는 요율에 대해 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요금의 소수점 이하 자릿수 구성을 참고하세요.

    예를 들어 0.10을 입력하고 통화가 미국 달러이면 거래 1건에 대해 개발자에게 0.10달러가 청구됩니다. 또는 트랜잭션에서 전송된 바이트 수와 같은 커스텀 속성을 기준으로 개발자에게 지정된 바이트 수 전송에 대해 0.10달러가 청구됩니다.

    볼륨 밴드 모델의 경우: 일반 요율표 창에는 집계 기준을 지정하고 '볼륨 밴드', 즉 다양한 요율을 적용할 수 있는 거래량의 범위를 지정하는 데 사용하는 추가 필드가 표시됩니다.

    이러한 유형의 계획은 일반적으로 개발자가 큰 볼륨 대역에 할인 요금을 제공하여 더 많은 볼륨을 생성하도록 장려하기 위해 설정됩니다.

    일반 요율표 창에 다음 정보를 입력합니다.

    필드 설명
    집계 기준

    거래량 (또는 맞춤 속성 관련 수량)이 집계되는 기간입니다. 집계된 볼륨은 각 거래에 적용할 볼륨 대역과 비율을 식별하는 데 사용됩니다. 개월 수(1~12개월)를 선택합니다.

    번들이 재설정되는 경우에 대한 자세한 내용은 언제 반복 수수료가 청구되고 번들 요금제가 재설정되나요?를 참고하세요.

    볼륨 밴드

    하나 이상의 거래 (또는 고객 속성 기반) 볼륨 범위입니다 (각 범위가 '볼륨 대역'). 각 볼륨 대역에는 요율을 할당할 수 있습니다 (가격 책정 섹션의 볼륨 대역 필드에서 이 요율 설정). 속도는 적용 가능한 볼륨 대역의 모든 트랜잭션에 적용됩니다. 첫 번째 대역의 상한을 지정합니다(예: 최대 1,000개(하한은 0보다 크게 미리 설정됨). +를 클릭하여 두 번째 대역을 추가합니다(예: 1, 000 초과 ~ 2, 000). 밴드를 더 추가하려면 +를 클릭합니다. 최종 대역의 상한선을 비워 이 수준을 초과하는 모든 트랜잭션을 나타낼 수 있습니다.

    가격 정보
    운영자 (또는 조직)

    조직 이름입니다. 이 필드는 조직 프로필의 연산자 (또는 조직) 필드 값을 사용하여 미리 설정됩니다.

    국가

    조직이 운영되는 국가입니다. 이 필드는 조직 프로필의 국가 필드 값을 사용하여 미리 설정됩니다.

    통화

    조직에서 사용하는 '기본' 또는 회계 통화입니다. 이 필드는 조직 프로필의 통화 필드 값을 사용하여 사전 설정되지만 여기에서 변경할 수 있습니다.

    볼륨 밴드

    볼륨 밴드의 속도입니다. 각 볼륨 밴드의 속도를 지정합니다. 각 밴드의 십진수를 입력하세요 (소수점 이하 최대 4자리).

    참고: UI가 아닌 API를 사용하여 볼륨 밴드 속도에 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요금의 소수점 이하 자릿수 구성을 참고하세요.

    예를 들어 볼륨 밴드 섹션에서 2개의 볼륨 밴드를 지정하는 경우(0~1000 이상, 1,000 이상), 0~1,000 이상의 볼륨 밴드에는 0.15를, 1,000 이상의 볼륨 밴드에는 0.10을 입력할 수 있습니다. 선택한 통화가 미국 달러인 경우 거래당 처음 1, 000건의 거래 요금은 거래당 $0.15이고, 거래가 1, 000건을 초과하는 경우에는 거래당 $0.10입니다.

    번들 모델: 일반 요율표 창에는 집계 기준 (개발자가 트랜잭션 번들을 사용할 수 있는 기간)을 지정하고 번들 크기와 같은 번들 관련 정보를 지정하는 데 사용하는 추가 필드가 표시됩니다.

    일반 요율표 창에 다음 정보를 입력합니다.

    필드 설명
    집계 기준

    개발자가 트랜잭션 번들을 사용 (또는 맞춤 속성 기반 번들을 사용)할 수 있는 기간입니다. 개월 수 (1~12개월)를 선택합니다. 이 기간이 지나면 요금제가 만료되고 개발자는 요금제와 번들을 다시 구매해야 합니다.

    번들이 재설정되는 경우에 대한 자세한 내용은 언제 반복 수수료가 청구되고 번들 요금제가 재설정되나요?를 참고하세요.

    번들 크기

    번들에 있는 트랜잭션 수 (또는 번들에서 전송된 총 바이트 수와 같은 커스텀 속성과 관련된 수)입니다. 각 번들에 가격을 할당할 수 있습니다. 가격은 가격 섹션의 번들 크기 필드에서 설정합니다. 이 가격은 전체 번들에 적용됩니다. 첫 번째 번들의 상한을 지정합니다(예: 최대 1,000개(하한은 0보다 크게 미리 설정됨). +를 클릭하여 두 번째 번들을 추가합니다(예: 1, 000에서 2, 000까지). 번들을 더 추가하려면 +를 클릭하세요. 마지막 번들의 무제한 트랜잭션에 대해 개발자에게 고정 금액을 청구하려는 경우가 아니라면 마지막 번들의 상한을 지정해야 합니다.

    가격 정보
    운영자 (또는 조직)

    조직 이름입니다. 이 필드는 조직 프로필의 연산자 (또는 조직) 필드 값을 사용하여 미리 설정됩니다.

    국가

    조직이 운영되는 국가입니다. 이 필드는 조직 프로필의 국가 필드 값을 사용하여 미리 설정됩니다.

    통화

    조직에서 사용하는 '기본' 또는 회계 통화입니다. 이 필드는 조직 프로필의 통화 필드 값을 사용하여 사전 설정되지만 여기에서 변경할 수 있습니다.

    번들 크기 (가격)

    번들의 가격입니다. 각 번들의 가격을 지정합니다. 십진수를 입력하세요 (소수점 이하 최대 4자리).

    참고: UI가 아닌 API를 사용하여 번들 요금에 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요금의 소수점 이하 자릿수 구성을 참고하세요.

    예를 들어 번들 크기 섹션에서 두 개의 번들 (0~1,000, 1,000~2,000)을 지정하는 경우 0~1,000개의 번들에는 50을, 1,000~2,000개의 번들에는 40을 입력할 수 있습니다. 선택한 통화가 미국 달러인 경우 첫 번째 번들의 가격은 50달러이고 두 번째 번들의 가격은 40달러입니다. 번들 내에서 사용하는 거래 수와 관계없이 개발자에게 관련 번들 가격이 청구됩니다. 즉, 번들의 첫 번째 거래가 완료되는 즉시 개발자에게 번들 가격이 청구됩니다.

  7. 적용 및 닫기를 클릭하여 요율표 세부정보를 저장하고 표준 요금제 창으로 돌아갑니다.
  8. API 제품별 요금제의 경우 필요에 따라 추가 API 제품의 요금제 세부정보를 구성합니다.

API를 사용하여 요율표 요금제 구성

다음 섹션에 설명된 대로 API를 사용하여 요율표 요금제 세부정보를 구성합니다.

API를 사용하여 요율표 요금제 세부정보 지정

요금제를 만들 때 요율표 요금제 세부정보를 지정합니다. /organizations/{org_name}/monetization-packages/{package_id}/rate-plans 호출에서 요청 본문 내의 ratePlanDetails 속성에 세부정보를 지정합니다. ratePlanDetails 속성에서 지정하는 항목은 선택한 충전 모델(고정 요금, 볼륨 밴드 또는 번들)에 따라 다릅니다.

정액제 청구 모델 지정

고정 요금 청구 모델을 구현하려면 요금제 세부정보에서 다음을 지정합니다.

  • 요금제가 트랜잭션(VOLUME) 또는 맞춤 속성 (예: MINT_CUSTOM_ATTRIBUTE_1)을 기반으로 함을 나타내는 평점 매개변수입니다. VOLUME가 기본값입니다.
  • 요금이 단위당 고정됨을 나타내는 한도 측정 유형(UNIT)(즉, 거래량을 기준으로 하지 않음(대역이 적용된 볼륨 또는 번들 충전 모델의 경우)).
  • 결제 기한 (예: 30일)입니다.
  • 조직의 ID입니다.
  • 회사에서 사용하는 '기본' 또는 회계 통화입니다.
  • 요율 계산 방법에 대한 세부정보를 제공하는 요금제 요율입니다. 청구 모델은 고정 요금을 기반으로 하므로 요금제 요율을 하나만 지정합니다.

요금제 요율에서 다음을 지정합니다.

  • 요금제 요율 유형 (RATECARD)입니다.
  • 요금제의 요율입니다. 예를 들어 0.10을 지정했는데 통화가 미국 달러이면 거래 1건에 대해 개발자에게 0.10달러가 청구됩니다. 또는 트랜잭션에서 전송된 바이트 수와 같은 커스텀 속성을 기준으로 한 경우에는 지정된 바이트 수 전송에 대해 개발자에게 0.10달러가 청구됩니다.
  • 요금 적용의 시작 단위 (0)입니다. 즉, 요율이 첫 번째 트랜잭션부터 각 트랜잭션에 적용됩니다.

요금제 세부정보 옵션의 전체 목록은 요금제 세부정보 구성 설정을 참고하세요.

예를 들어 다음은 고정 청구 모델로 요율표 요금제를 만듭니다. 이 요율은 거래당 $0.10로 설정됩니다. 결제 기한은 30일입니다. 요율표 관련 세부정보는 강조 표시됩니다.

curl -H "Content-Type:application/json" -X POST -d \
'{ 
     "name": "Flat rate card plan",
     "developer":null,
     "developerCategory":null,
     "advance": "false",
     "currency": {
      "id" : "usd"
     },     
     "description": "Flat rate card plan",
     "displayName" : "Flat rate card plan",
     "frequencyDuration": "30",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",     
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "paymentDueDays": "30",
     "prorate": "false",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "paymentDueDays": "30",      
      "meteringType": "UNIT",
      "organization": {
       "id": "{org_name}"
      },
      "ratePlanRates": [
       {
        "type": "RATECARD",
        "rate": "0.10",
        "startUnit": "0"       
       }      
      ], 
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

볼륨 밴드 충전 모델 지정

볼륨 밴드 모델에서는 하나 이상의 요금제 요율이 포함된 요금제 세부정보를 지정합니다. 각 요율은 '볼륨 대역', 즉 거래 볼륨 범위 (또는 전송된 바이트 수와 같은 커스텀 속성에 기반한 범위)에 적용됩니다. 이러한 유형의 계획은 일반적으로 개발자가 대규모 볼륨 대역에 할인 요금을 제공하여 더 많은 볼륨을 생성하도록 장려하기 위해 설정됩니다.

요금제 요금 외에도 요금제 세부정보에서 다음을 지정합니다.

  • 요금제가 트랜잭션(VOLUME) 또는 맞춤 속성 (예: CUSTOM_ATTRIBUTE_1)을 기반으로 함을 나타내는 평점 매개변수입니다. VOLUME가 기본값입니다.
  • 요금이 트랜잭션 양을 기반으로 함을 나타내는 한도 측정 유형(VOLUME)입니다. 즉, 고정 요금 청구 모델과 마찬가지로 트랜잭션당 고정 요금이 아닙니다.
  • 결제 기한 (예: 30일)입니다.
  • 조직의 ID입니다.
  • 회사에서 사용하는 '기본' 또는 회계 통화입니다.
  • 거래 수량 (또는 맞춤 속성 관련 수량)이 집계되는 기간을 함께 지정하는 기간 및 기간 유형입니다. 이를 '집계 기반'이라고도 합니다. 트랜잭션 볼륨은 적용 가능한 볼륨 대역을 결정하기 위해 집계 기준 (예: 1개월)을 기준으로 집계됩니다.
  • 적용 가능한 볼륨 대역을 결정하는 데 사용되는 집계 카운터

각 요금제 요율에 대해 다음을 지정합니다.

  • 요금제 요율 유형 (RATECARD)입니다.
  • 요금제의 요율입니다. 예를 들어 0.10을 지정했는데 통화가 미국 달러이면 거래 건당 0.15달러가 개발자에게 청구됩니다. 또는 트랜잭션에서 전송된 바이트 수와 같은 커스텀 속성을 기준으로 하는 경우에는 지정된 바이트 수 전송에 대해 개발자에게 0.15달러가 청구됩니다.
  • 볼륨 밴드의 시작 및 종료 단위입니다. 시작 단위는 볼륨 밴드의 하한을 지정하고 끝 단위는 볼륨 밴드의 상한을 지정합니다. 예를 들어 시작 단위를 0으로, 종료 단위를 1,000으로 지정하면 볼륨 대역은 집계 기간에 최대 1,000회의 트랜잭션에 적용됩니다. 통화가 미국 달러인 경우 집계 기간은 1개월이고 처음 1, 000건의 트랜잭션 이자율이 0.15이면 개발자에게 해당 월에 최대 1, 000건의 트랜잭션에 대해 거래당 $0.15가 청구됩니다.

    번들이 재설정되는 경우에 대한 자세한 내용은 언제 반복 수수료가 청구되고 번들 요금제가 재설정되나요?를 참고하세요.

    최종 볼륨 대역의 종료 단위를 지정하지 않으면 트랜잭션 수가 해당 대역의 시작 단위를 초과한 후 모든 트랜잭션에 해당 대역의 속도가 적용됩니다. 예를 들어 마지막 대역의 시작 단위가 1, 000이고 이 대역의 종료 단위를 지정하지 않으면 대역의 비율이 집계 기간에 트랜잭션 1, 000회 이후의 모든 트랜잭션에 적용됩니다.

요금제 세부정보 옵션의 전체 목록은 요금제 세부정보 구성 설정을 참고하세요.

예를 들어 다음은 볼륨 밴드 청구 모델을 사용하는 요율표 요금제를 만듭니다. 이 요율은 처음 1,000건의 트랜잭션은 $0.15, 1,000을 초과하는 모든 트랜잭션은 $0.10로 설정됩니다. 집계 기준은 1개월입니다. 결제 기한은 30일입니다. 요율표 세부정보는 강조 표시됩니다.

curl -H "Content-Type:application/json" -X POST -d \

'{
     "name": "Volume banded rate card plan",
     "developer":null,
     "developerCategory":null,
     "currency": {
      "id" : "usd"
     },     
     "frequencyDuration": "30",
     "description": "Volume banded rate card plan",
     "displayName" : "Volume banded rate card plan",
     "frequencyDuration": "30",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },    
     "paymentDueDays": "30",
     "prorate": "false",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "aggregateStandardCounters": true,
      "paymentDueDays": "30",
      "duration": "1",
      "durationType": "MONTH",
      "meteringType": "VOLUME",
      "organization": {
       "id": "{org_name}"
      },      
      "ratePlanRates": [
      {
       "type": "RATECARD",
       "rate": "0.15",
       "startUnit": "0",
       "endUnit": "1000"
      },
      {
       "type": "RATECARD",
       "rate": "0.10",
       "startUnit": "1000"      
      }
      ],     
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

번들 충전 모델 지정

번들 청구 모델에서는 개발자가 트랜잭션의 '번들'(또는 전송된 바이트 수와 같은 커스텀 속성을 기반으로 한 번들)에 대해 선불로 지불합니다. 각 번들의 요율과 집계 기준(즉, 개발자가 번들을 사용할 수 있는 기간)을 지정합니다.

예를 들어 첫 번째 번들 크기가 1~1, 000회 트랜잭션이고 두 번째 번들 크기가 1, 001~2, 000회인 두 개의 번들을 설정했다고 가정해 보겠습니다. 요율은 첫 번째 번들에 $50, 두 번째 번들에 $40이며 집계 기준은 1입니다. 개발자가 첫 번째 번들의 요율표 요금제를 구매하면 한 달에 거래 1, 000건에 대해 $50 (선불)를 지불합니다. 번들 전체 사용 여부와 관계없이 개발자에게 설정된 금액이 청구됩니다. 집계 기간이 끝나면 계획이 만료됩니다. 개발자가 번들을 다시 사용하려면 요금제와 번들을 다시 구매해야 합니다.

요금제 세부정보에 지정하는 사항은 기본적으로 볼륨 밴드 충전 모델의 요금제 세부정보에 지정한 것과 동일합니다. 차이는 다음과 같습니다.

  • 지정하는 각 요금제는 볼륨 밴드가 아닌 번들 요금제입니다.
  • 마지막 번들의 무제한 트랜잭션에 대해 개발자에게 고정 금액을 청구하려는 경우가 아니라면 마지막 번들의 상한을 지정해야 합니다.

요금제 세부정보 옵션의 전체 목록은 요금제 세부정보 구성 설정을 참고하세요.

예를 들어 다음은 번들 청구 모델이 포함된 요율표 요금제를 만듭니다. 첫 번째 번들 (거래 최대 1,000건)에는 요율이 $50, 두 번째 번들 (최대 1,000건 및 최대 2,000건)의 경우 $40로 설정됩니다. 집계 기준은 1개월입니다. 결제 기한은 30일입니다.

curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "Bundled rate plan",
     "developer":null,
     "developerCategory":null,
     "currency": {
      "id" : "usd"
     },    
     "frequencyDuration": "30",
     "description": "Bundled rate plan",
     "displayName" : "Bundled rate plan",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },    
     "paymentDueDays": "30",
     "prorate": "true",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "aggregateStandardCounters": true,
      "paymentDueDays": "30",
      "duration": "1",
      "durationType": "MONTH",
      "meteringType": "STAIR_STEP",
      "organization": {
       "id": "{org_name}"
      },
      "ratePlanRates": [
      {
       "type": "RATECARD",
       "rate": "50",
       "startUnit": "0",
       "endUnit": "1000"
      },
      {
       "type": "RATECARD",
       "rate": "40",
       "startUnit": "1000",
       "endUnit": "2000"
      }
      ],
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2013-09-15 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password

API를 사용하여 개별 제품에 대한 부분 유료화 요금제 지정

요율표 요금제에서는 API 패키지가 아닌 개별 제품에 부분 유료 모델 요금제를 설정할 수 있습니다. 부분 유료화(Freemium) 요금제는 개발자에게 일정 기간 동안 또는 사용량에 따라 API 제품을 무료로 사용할 수 있는 기회를 제공합니다.

API 제품의 부분 유료 모델 요금제를 설정할 때 요율표 요금제 세부정보에 개발자가 API 제품에서 제공하는 리소스를 무료로 사용할 수 있는 기간을 명시합니다. 이 기간은 다음 중 하나를 기준으로 할 수 있습니다.

  • 기간, 즉 시행일과 종료일 사이의 시간입니다.
  • 수량(예: API 제품과 관련된 거래 수 또는 거래 기록 정책에 기록된 맞춤 속성과 관련된 수량)

부분 유료화 기간이 수량을 기준으로 하는 경우 부분 유료화 단위의 수로 지정합니다. 예를 들어 다음은 5, 000단위를 기준으로 부분 유료화 요금제를 사용하는 요율표 요금제를 만듭니다 (부분 유료화 관련 사양이 강조 표시됨).

curl -H "Content-Type:application/json" -X POST -d \
'{
      "name": "Flat rate card plan with freemium period",
      "developer":null,
      "developerCategory":null,      
      "advance": "false",
      "currency": {
       "id" : "usd"
      },     
      "description": "Flat rate card plan with freemium period",
      "displayName" : "Flat rate card plan with freemium period",
      "frequencyDuration": "30",
      "frequencyDurationType": "DAY",
      "earlyTerminationFee": "10",     
      "monetizationPackage": {
       "id": "location"
      },
      "organization": {
       "id": "myorg"
      },
      "paymentDueDays": "30",
      "prorate": "false",
      "published": "false",
      "ratePlanDetails": [
      {
       "currency": {
       "aggregateFreemiumCounters" : true,
       "aggregateStandardCounters" : true,
        "id" : "usd"
       },
       "product" : {
        "id" : "location",
        "displayName":"Location"
       },
       "paymentDueDays": "30",      
       "meteringType": "UNIT",
       "organization": {
        "id": "myorg"
       },
       "ratePlanRates": [
        {
         "type": "RATECARD",
         "rate": "0.10",
         "startUnit": "0"       
        }      
       ],
      "freemiumUnit": "5000",
      "freemiumDuration": "0",
      "freemiumDurationType": "DAY",
      "ratingParameterUnit":"MB",
      "customPaymentTerm": "false",
      "ratingParameter": "VOLUME",
      "type": "RATECARD"
      }],
      "recurringStartUnit": 1,
      "recurringType": "CALENDAR",
      "recurringFee": "10",
      "setUpFee": "10",
      "startDate": "2013-09-15 00:00:00",
      "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password