요율표 요금제 구성

Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보

소개

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

원하는 경우 API 패키지가 아닌 개별 제품에 대해 프리미엄 요금제를 지정할 수 있습니다. 제품별 요금제에 대해서만 지정할 수 있습니다.

반복 결제 요금이 청구되고 번들 요금제가 재설정되는 시기는 언제인가요?

요금제에는 반복 수수료와 API 번들 (볼륨 구간 및 번들 요금제)이 모두 포함될 수 있으며, 두 요금제 모두 수수료가 청구되고 번들 요금제가 0으로 재설정되는 특정 시간이 있습니다. 다음 표에서는 반복 결제가 청구되고 번들 수가 재설정되는 시점을 설명합니다. 개발자 앱이 특정 거래 한도에 도달하여 더 이상 API를 호출할 수 없게 차단되면 API 호출 수가 0으로 재설정되고 앱이 다시 호출을 시작할 수 있습니다.

요금제에 다음이 포함된 경우	...이러한 문제가 발생합니다.
0이 아닌 반복 요금이 월로 설정됨 볼륨 요금제 또는 번들 요금제	반복 수수료 및 번들 요금제 재설정은 매월 1일에 이루어집니다 (기본값). 특정일에 매월 반복되는 경우 관리 API를 사용하여 요금제를 만들고 API를 사용하여 요금제 만들기에 설명된 대로 RecurringStartUnit 속성으로 요금제 일자를 표시합니다.
0이 아닌 반복 수수료가 주로 설정됨 볼륨 기반 또는 번들 요금제	반복 수수료 및 번들 요금제는 개발자의 요금제 시작일로부터 7일마다 재설정됩니다.
0이 아닌 반복 수수료가 일로 설정됨 볼륨 밴드 또는 번들 요금제	반복 수수료 및 번들 요금제는 개발자의 요금제 시작일로부터 X일마다 재설정됩니다.
반복 청구 요금 없음 (또는 0달러) 볼륨 요금제 또는 번들 요금제	번들 요금제는 요금 카드에 정의된 집계 기준에 따라 재설정됩니다. 예를 들어 개발자가 매월 19일에 요금제를 시작하고 집계 기준이 1개월마다인 경우 번들 사용량은 매월 19일에 재설정됩니다. 요일은 항상 동일하지 않을 수 있습니다. 예를 들어 요금제가 12월 31일에 시작되는 경우 2월에는 28일밖에 없으므로 윤년이 아닌 해의 2월 28일이 재설정일입니다. 그러면 28일이 재설정 날짜로 유지됩니다.

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

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

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을 지정하고 통화가 미국 달러인 경우 개발자에게 거래 건별로 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 패키지가 아닌 개별 제품에 대해 무료 체험판 요금제를 설정할 수 있습니다. 프리미엄 요금제는 개발자에게 일정 기간 동안 또는 사용량에 따라 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