Định cấu hình gói thẻ giá

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X. thông tin

Giới thiệu

Trong gói giá, nhà phát triển sẽ bị tính phí cho mỗi giao dịch. Đối với loại gói này, bạn cần cung cấp thêm thông tin chi tiết, chẳng hạn như kiểu sạc và giá của mẫu sạc.

Nếu muốn, bạn có thể chỉ định gói miễn phí cho các sản phẩm riêng lẻ (thay vì cho gói API). Bạn chỉ có thể thực hiện việc này cho gói dành riêng cho sản phẩm.

Khi nào các gói thuê bao theo gói sẽ được tính phí định kỳ?

Các gói giá có thể bao gồm cả phí định kỳ cũng như gói API (gói theo băng tần và gói theo gói), cả hai loại gói đều liên quan đến một thời điểm cụ thể mà phí được tính và các gói được đặt lại về 0. Bảng sau đây mô tả thời điểm tính phí định kỳ và đặt lại số lượng gói. Nếu các ứng dụng của nhà phát triển bị chặn thực hiện thêm lệnh gọi API do đã đạt đến một giới hạn giao dịch nhất định, thì đây là thời điểm khi số lệnh gọi API được đặt lại về 0 và các ứng dụng có thể bắt đầu gọi lại.

Nếu kế hoạch có...	...điều này xảy ra
Phí định kỳ khác 0 được đặt thành Tháng Gói theo băng tần số lượng hoặc gói theo gói	Phí định kỳ và việc đặt lại gói gói sẽ diễn ra vào ngày đầu tiên của tháng (mặc định). Đối với trường hợp lặp lại hằng tháng vào một ngày cụ thể, hãy tạo gói giá bằng API quản lý và chỉ rõ ngày đó bằng cơ sở lưu trú RecurringStartUnit, như mô tả trong phần Tạo gói giá bằng API.
Đã đặt phí định kỳ khác 0 thành Tuần Gói theo băng tần số lượng hoặc gói theo gói	Phí định kỳ và việc đặt lại gói gói sẽ diễn ra 7 ngày một lần sau ngày bắt đầu gói giá của nhà phát triển.
Đã đặt phí định kỳ khác 0 thành Ngày Gói theo băng tần số lượng hoặc gói theo gói	Phí định kỳ và việc đặt lại gói gói sẽ diễn ra X ngày một lần sau ngày bắt đầu gói giá của nhà phát triển.
Không có phí định kỳ (hoặc một khoản phí định kỳ bằng 0 đồng) Gói theo băng tần số lượng hoặc gói theo gói	Các gói giá được đặt lại dựa trên Cơ sở tổng hợp được xác định trên thẻ giá. Ví dụ: nếu nhà phát triển bắt đầu một gói giá vào ngày 19 của tháng và Cơ sở tổng hợp là 1 tháng một lần, thì việc sử dụng gói sẽ được đặt lại vào ngày 19 hằng tháng. Xin lưu ý rằng ngày trong tháng có thể không phải lúc nào cũng giống nhau. Ví dụ: nếu gói giá bắt đầu vào ngày 31/12, thì ngày đặt lại sẽ trở thành ngày 28 của một tháng không phải năm nhuận vì tháng 2 chỉ có 28 ngày. Ngày 28 vẫn là ngày được đặt lại từ trước đến nay.

Định cấu hình gói giá bằng giao diện người dùng

Định cấu hình gói bảng giá như mô tả bên dưới.

Định cấu hình gói giá bằng API

Sử dụng API để định cấu hình thông tin về gói giá theo mô tả trong các phần sau.

Chỉ định chi tiết gói giá bằng API

Bạn chỉ định chi tiết gói giá khi bạn tạo gói giá. Bạn cần chỉ định thông tin chi tiết trong thuộc tính ratePlanDetails trong nội dung yêu cầu trong lệnh gọi đến /organizations/{org_name}/monetization-packages/{package_id}/rate-plans. Nội dung bạn chỉ định trong thuộc tính ratePlanDetails phụ thuộc vào mô hình tính phí bạn chọn: mức phí cố định, theo dải âm lượng hoặc gói.

Chỉ định mô hình sạc tốc độ cố định

Để triển khai mô hình tính phí theo mức phí cố định, hãy chỉ định những thông tin sau trong phần thông tin chi tiết về gói giá:

• Một thông số xếp hạng cho biết rằng gói giá dựa trên các giao dịch (VOLUME) hoặc dựa trên một thuộc tính tuỳ chỉnh (ví dụ: MINT_CUSTOM_ATTRIBUTE_1). VOLUME là giá trị mặc định.
• Loại định mức (UNIT) cho biết mức phí cố định trên mỗi đơn vị (nghĩa là, mức phí này không dựa trên số lượng giao dịch, như trong trường hợp mô hình tính phí theo dải số lượng hoặc theo gói).
• Thời hạn thanh toán (ví dụ: 30 ngày).
• Mã tổ chức của bạn.
• Đơn vị tiền tệ "cơ sở" hoặc đơn vị tiền tệ kế toán mà công ty của bạn sử dụng.
• Giá gói giá cung cấp thông tin chi tiết về cách tính giá. Vì mô hình tính phí dựa trên một mức giá cố định, nên bạn chỉ cần chỉ định một mức giá cho một gói giá.

Trong mức giá của gói giá, bạn chỉ định:

• Loại mức giá của gói giá (RATECARD).
• Mức giá cho kế hoạch. Ví dụ: nếu bạn chỉ định 0,10 và đơn vị tiền tệ là đô la Mỹ, thì nhà phát triển sẽ phải trả 0,1 USD cho mỗi giao dịch (hoặc nếu dựa trên một thuộc tính tuỳ chỉnh như số byte được truyền trong một giao dịch, thì nhà phát triển sẽ bị tính phí 0,1 USD cho việc truyền số lượng byte được chỉ định).
• Đơn vị bắt đầu của việc áp dụng giá (0). Tức là mức giá được áp dụng cho từng giao dịch, bắt đầu từ giao dịch đầu tiên.

Hãy xem phần Chế độ cài đặt cấu hình của gói giá để nắm được danh sách đầy đủ các lựa chọn chi tiết của gói giá.

Ví dụ: nội dung sau đây sẽ tạo một gói giá có mô hình tính phí cố định. Mức giá được đặt ở mức 0,1 đô la Mỹ cho mỗi giao dịch. Khoản thanh toán sẽ đến hạn sau 30 ngày. (Các thông tin chi tiết liên quan đến bảng giá được làm nổi bật.)

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

Chỉ định mô hình sạc theo dải âm lượng

Trong mô hình theo dải khối lượng, bạn chỉ định chi tiết gói giá bao gồm một hoặc nhiều mức giá gói giá, mỗi mức giá áp dụng cho một "băng tần khối lượng", tức là phạm vi khối lượng giao dịch (hoặc một phạm vi dựa trên thuộc tính tuỳ chỉnh chẳng hạn như số byte được truyền). Loại gói này thường được thiết lập để khuyến khích nhà phát triển tạo ra nhiều dung lượng lưu trữ hơn bằng cách đưa ra mức giá chiết khấu cho những khoảng trống lớn hơn.

Ngoài mức giá của gói giá, bạn còn phải chỉ định những thông tin sau đây trong phần thông tin chi tiết của gói giá:

• Một thông số xếp hạng cho biết rằng gói giá dựa trên các giao dịch (VOLUME) hoặc dựa trên một thuộc tính tuỳ chỉnh (ví dụ: CUSTOM_ATTRIBUTE_1). VOLUME là giá trị mặc định.
• Loại định mức (VOLUME) cho biết rằng mức phí dựa trên số lượng giao dịch (nghĩa là mức phí không phải là mức cố định cho mỗi giao dịch, như trong trường hợp của mô hình tính phí theo mức phí cố định).
• Thời hạn thanh toán (ví dụ: 30 ngày).
• Mã tổ chức của bạn.
• Đơn vị tiền tệ "cơ sở" hoặc đơn vị tiền tệ kế toán mà công ty của bạn sử dụng.
• Loại khoảng thời gian và khoảng thời gian chỉ định khoảng thời gian tổng hợp số lượng giao dịch (hoặc lượng giao dịch liên quan đến thuộc tính tuỳ chỉnh). Cơ chế này cũng được gọi là "cơ sở tổng hợp". Số lượng giao dịch được tổng hợp trên cơ sở tổng hợp (ví dụ: 1 tháng) để xác định biên độ khối lượng áp dụng.
• Bộ đếm tổng hợp dùng để xác định biên độ khối lượng phù hợp.

Đối với mỗi mức giá của gói giá, bạn sẽ chỉ định:

• Loại mức giá của gói giá (RATECARD).
• Mức giá cho kế hoạch. Ví dụ: nếu bạn chỉ định 0,10 và đơn vị tiền tệ là đô la Mỹ, thì nhà phát triển sẽ phải trả 0,15 USD cho mỗi giao dịch (hoặc nếu dựa trên một thuộc tính tuỳ chỉnh như số byte được truyền trong một giao dịch, thì nhà phát triển sẽ bị tính phí 0,15 USD cho việc truyền số lượng byte được chỉ định).
• Đơn vị bắt đầu và kết thúc của dải âm lượng. Đơn vị bắt đầu chỉ định giới hạn dưới của dải âm lượng, còn đơn vị kết thúc chỉ định giới hạn trên của dải âm lượng. Ví dụ: nếu bạn chỉ định đơn vị bắt đầu là 0 và đơn vị kết thúc là 1000, thì phạm vi khối lượng sẽ bao gồm tối đa 1000 giao dịch trong khoảng thời gian tổng hợp. Nếu đơn vị tiền tệ là đô la Mỹ, khoảng thời gian tổng hợp là 1 tháng và tỷ lệ cho 1000 giao dịch đầu tiên là 0,15, thì nhà phát triển sẽ phải trả 0,15 USD cho mỗi giao dịch cho tối đa 1.000 giao dịch trong tháng.
  
  Để biết thông tin chi tiết về thời điểm đặt lại gói, hãy xem bài viết Khi nào hệ thống tính phí định kỳ và các gói được đặt lại?
  

  Nếu bạn không chỉ định đơn vị kết thúc cho dải số lượng cuối cùng, giá cho băng tần đó sẽ được áp dụng cho tất cả giao dịch sau khi số lượng giao dịch đã vượt quá đơn vị bắt đầu của dải đó. Ví dụ: nếu đơn vị bắt đầu của dải cuối cùng là 1000 và bạn không chỉ định đơn vị kết thúc cho dải đó, thì tỷ lệ cho dải sẽ được áp dụng cho tất cả giao dịch sau 1000 giao dịch trong khoảng thời gian tổng hợp.

Hãy xem phần Chế độ cài đặt cấu hình của gói giá để nắm được danh sách đầy đủ các lựa chọn chi tiết của gói giá.

Ví dụ: nội dung sau đây sẽ tạo một gói giá có mô hình tính phí theo dải mức âm lượng. Mức giá được đặt ở mức 0,15 đô la cho 1.000 giao dịch đầu tiên và 0,10 đô la cho tất cả các giao dịch trên 1.000 giao dịch. Cơ sở tổng hợp là 1 tháng. Khoản thanh toán sẽ đến hạn sau 30 ngày. (Thông tin về bảng giá được làm nổi bật.)

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

Chỉ định một mô hình sạc theo gói

Trong mô hình tính phí theo gói, nhà phát triển sẽ thanh toán (trả trước) cho một "gói" giao dịch (hoặc cho một gói dựa trên thuộc tính tuỳ chỉnh, chẳng hạn như số byte được truyền). Bạn chỉ định một mức giá cho mỗi gói và một cơ sở tổng hợp, tức là khoảng thời gian mà nhà phát triển có thể sử dụng gói đó.

Ví dụ: giả sử bạn thiết lập hai gói, trong đó kích thước gói đầu tiên là từ 1 đến 1000 giao dịch và kích thước gói thứ hai là từ 1001 đến 2000 giao dịch. Mức giá là 50 đô la Mỹ cho gói đầu tiên và 40 đô la Mỹ cho gói thứ hai, và cơ sở tổng hợp là 1. Nếu nhà phát triển mua gói giá cho gói đầu tiên, thì họ sẽ thanh toán 50 USD (trả trước) cho 1.000 giao dịch trong một tháng. Nhà phát triển vẫn phải trả số tiền đã đặt cho dù gói đó có được sử dụng hết hay không. Sau khi khoảng thời gian tổng hợp kết thúc, gói sẽ hết hạn. Nếu muốn sử dụng lại gói đó, nhà phát triển phải mua lại gói đó (và gói đó).

Về cơ bản, nội dung bạn chỉ định trong chi tiết gói giá cũng giống với nội dung bạn chỉ định trong chi tiết gói giá cho mô hình tính phí theo dải mức âm lượng. Sau đây là những điểm khác biệt:

• Mỗi gói giá mà bạn chỉ định là dành cho một gói (chứ không phải cho một khoảng âm lượng).
• Bạn phải chỉ định giới hạn trên cho gói cuối cùng, trừ khi bạn muốn tính phí cho nhà phát triển một số tiền cố định cho các giao dịch không giới hạn trong gói trước.

Hãy xem phần Chế độ cài đặt cấu hình của gói giá để nắm được danh sách đầy đủ các lựa chọn chi tiết của gói giá.

Ví dụ: nội dung sau đây sẽ tạo một gói bảng giá có một mô hình tính phí đi kèm. Mức giá được đặt ở mức 50 đô la Mỹ cho gói đầu tiên (tối đa 1.000 giao dịch) và 40 đô la cho gói thứ hai (hơn 1.000 giao dịch và tối đa 2.000 giao dịch). Cơ sở tổng hợp là 1 tháng. Khoản thanh toán sẽ đến hạn sau 30 ngày.

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

Chỉ định gói thu phí trong miễn phí cho từng sản phẩm bằng API

Trong một gói giá, bạn có thể thiết lập gói thu phí trong miễn phí cho một sản phẩm riêng lẻ (thay vì cho gói API). Gói thu phí trong miễn phí cho phép nhà phát triển sử dụng miễn phí một sản phẩm API trong một khoảng thời gian hoặc dựa trên mức sử dụng.

Khi thiết lập gói miễn phí cho một sản phẩm API, bạn phải chỉ định trong bảng giá nêu chi tiết khoảng thời gian nhà phát triển có thể sử dụng miễn phí tài nguyên do sản phẩm API cung cấp. Khoảng thời gian này có thể dựa vào một trong các yếu tố sau:

• Thời lượng, tức là khoảng thời gian giữa ngày có hiệu lực và ngày kết thúc.
• Số lượng, chẳng hạn như số lượng giao dịch liên quan đến sản phẩm API hoặc khối lượng liên quan đến một thuộc tính tuỳ chỉnh được ghi lại trong chính sách ghi nhận giao dịch.

Nếu chu kỳ thu phí trong miễn phí dựa trên số lượng, hãy chỉ định thời gian này dưới dạng số đơn vị thu phí trong miễn phí. Ví dụ: nội dung sau đây sẽ tạo một gói giá với gói thu phí trong miễn phí dựa trên số lượng 5.000 đơn vị (các thông số kỹ thuật liên quan đến thu phí trong miễn phí sẽ được làm nổi bật).

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