Đị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 theo bảng 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, chẳng hạn như mô hình tính phí và giá của mô hình tính phí.

Bạn có thể chỉ định gói miễn phí cho từng sản phẩm (thay vì cho một gói API) – bạn chỉ có thể thực hiện việc này cho một gói dành riêng cho sản phẩm.

Khi nào các khoản phí định kỳ được tính và gói thuê bao được đặt lại?

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

Nếu gói đó có...	...điều này sẽ xảy ra
Phí định kỳ khác 0 được đặt thành Tháng Gói theo băng thông hoặc gói đi kèm	Phí định kỳ và gói thuê bao sẽ được đặt lại vào ngày đầu tiên của tháng (mặc định). Đối với lịch trình định kỳ hằng tháng vào một ngày cụ thể, hãy tạo một gói giá bằng cách sử dụng API quản lý và chỉ định ngày bằng thuộc tính RecurringStartUnit, như mô tả trong phần Tạo gói giá bằng API.
Phí định kỳ khác 0 được đặt thành Tuần Gói âm lượng theo gói hoặc gói	Việc đặt lại phí định kỳ và gói giá 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 một khoản phí định kỳ khác 0 thành Ngày Gói âm lượng theo gói hoặc gói	Việc đặt lại phí định kỳ và gói sẽ diễn ra sau mỗi X ngày kể từ ngày bắt đầu gói giá của nhà phát triển.
Không có phí định kỳ (hoặc phí bằng 0 đô la) Gói âm lượng theo gói hoặc gói	Các gói theo gói đượ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à mỗi 1 tháng, thì mứ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 một kế hoạch giá bắt đầu vào ngày 31 tháng 12, thì ngày đặt lại sẽ là ngày 28 tháng 2 của năm không nhuận vì tháng 2 chỉ có 28 ngày. Ngày 28 sẽ vẫn là ngày đặt lại.

Định cấu hình kế hoạch bảng giá bằng giao diện người dùng

Định cấu hình các gói theo bảng giá như mô tả dưới đây.

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

Định cấu hình thông tin chi tiết về gói giá theo thẻ giá bằng API, như mô tả trong các phần sau.

Chỉ định thông tin chi tiết về gói giá trong thẻ giá bằng API

Bạn chỉ định thông tin chi tiết về gói giá trong thẻ giá khi tạo gói giá. Bạn chỉ định thông tin chi tiết trong thuộc tính ratePlanDetails trong phần 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í mà bạn chọn: mức giá cố định, theo nhóm số lượng hoặc gói.

Chỉ định mô hình sạc theo mức giá cố định

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

• Thông số phân loại cho biết rằng gói giá được tính dựa trên 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 đo lượng (UNIT) cho biết mức giá cố định cho mỗi đơn vị (tức là 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 gói hoặc theo nhóm).
• Thời hạn thanh toán (ví dụ: 30 ngày).
• Mã nhận dạng của tổ chức.
• Đơn vị tiền tệ "gốc" hoặc đơn vị tiền tệ kế toán mà công ty của bạn sử dụng.
• Mức giá gói giá cung cấp thông tin chi tiết về cách tính mức giá. Vì mô hình tính phí dựa trên mức giá cố định, nên bạn chỉ chỉ định một mức giá trong gói giá.

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

• Loại giá của gói giá (RATECARD).
• Mức giá của gói. Ví dụ: nếu bạn chỉ định 0,1 và đơn vị tiền tệ là đô la Mỹ, thì nhà phát triển sẽ bị tính phí 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, chẳng hạn như số byte được truyền trong giao dịch, nhà phát triển sẽ bị tính phí 0,1 USD khi truyền số byte đã chỉ định).
• Đơn vị bắt đầu áp dụng mức giá (0). Điều này có nghĩa là mức giá được áp dụng cho từng giao dịch, bắt đầu từ giao dịch đầu tiên.

Xem phần Chế độ cài đặt cấu hình chi tiết gói giá để xem danh sách đầy đủ các lựa chọn chi tiết về gói giá.

Ví dụ: đoạn mã sau đây tạo một gói bảng giá có mô hình tính phí cố định. Mức phí này được đặt là 0,10 đô la cho mỗi giao dịch. Khoản thanh toán sẽ đến hạn sau 30 ngày. (Thông tin liên quan đến bảng giá được đánh dấu.)

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 dung lượng

Trong mô hình phân chia theo dải số lượng, bạn sẽ chỉ định thông tin chi tiết về gói giá bao gồm một hoặc nhiều mức giá cho gói giá, mỗi mức giá áp dụng cho một "nhóm theo số lượng", tức là một phạm vi số lượng giao dịch (hoặc một phạm vi dựa trên một thuộc tính tuỳ chỉnh 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 số lượng lớn hơn bằng cách cung cấp mức giá chiết khấu cho các dải số lượng lớn hơn.

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

• Thông số phân loại cho biết rằng gói giá được tính dựa trên 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.
• Một loại định mức (VOLUME) cho biết rằng mức phí dựa trên số lượng giao dịch (tức là không phải mức phí cố định trên mỗi giao dịch, như trường hợp của mô hình tính phí cố định).
• Khoảng thời gian đến hạn thanh toán (ví dụ: 30 ngày).
• Mã nhận dạng của tổ chức.
• Đơn vị tiền tệ "gốc" hoặc đơn vị tiền tệ kế toán mà công ty của bạn sử dụng.
• Loại thời hạn và thời hạn cùng chỉ định khoảng thời gian tổng hợp khối lượng giao dịch (hoặc khối lượng liên quan đến thuộc tính tuỳ chỉnh). Đâ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 dải khối lượng giao dịch hiện hành.
• Bộ đếm tổng hợp dùng để xác định dải âm lượng hiện hành.

Đối với mỗi mức giá gói giá, bạn cần nêu rõ:

• Loại mức giá gói giá (RATECARD).
• Mức giá của gói. 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ẽ bị tính phí 0,15 đô la 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 đô la cho việc truyền số byte đã chỉ định).
• Đơn vị bắt đầu và kết thúc của dải âm lượng. Đơn vị đầu chỉ định giới hạn dưới của dải âm lượng, còn đơn vị kết thúc là 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à 1.000, thì dải âm lượng sẽ bao gồm tối đa 1.000 giao dịch trong kỳ tổng hợp. Nếu đơn vị tiền tệ là đô la Mỹ, thời gian tổng hợp là 1 tháng và tỷ lệ cho 1.000 giao dịch đầu tiên là 0,15, thì nhà phát triển sẽ phải trả 0,15 đô la Mỹ cho mỗi giao dịch đối với 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 phí định kỳ được tính và gói được đặt lại?
  

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

Hãy xem phần Cài đặt cấu hình chi tiết về gói giá để biết danh sách đầy đủ các tuỳ chọn chi tiết về gói giá.

Ví dụ: đoạn mã sau đây tạo một gói theo bảng giá có mô hình tính phí theo băng thông. Mức phí này được đặt là 0,15 đô la Mỹ cho 1.000 giao dịch đầu tiên và 0,10 đô la Mỹ cho tất cả giao dịch trên 1.000. 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 chi tiết 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 trả phí (trước) cho một "gói" giao dịch (hoặc cho một gói dựa trên một 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à 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 đó gói đầu tiên có kích thước từ 1 đến 1.000 giao dịch và gói thứ hai có kích thước từ 1.001 đến 2.000 giao dịch. Mức giá là 50 đô la cho gói đầu tiên và 40 đô la cho gói thứ hai, còn 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, họ sẽ trả 50 đô la (trả trước) cho 1.000 giao dịch trong một tháng. Nhà phát triển sẽ bị tính phí theo 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, kế hoạch 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 thuê bao đó.

Thông tin bạn chỉ định trong chi tiết gói giá về cơ bản giống với thông tin bạn chỉ định trong chi tiết gói giá cho mô hình tính phí theo băng thô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 (thay vì một dải dung lượng).
• Bạn phải chỉ định giới hạn trên cho gói cuối cùng, trừ phi bạn muốn tính phí nhà phát triển một số tiền cố định cho số lượng giao dịch không giới hạn trong gói cuối cùng.

Xem phần Chế độ cài đặt cấu hình chi tiết gói giá để xem danh sách đầy đủ các lựa chọn chi tiết về gói giá.

Ví dụ: nội dung sau đây sẽ tạo một gói giá theo mô hình tính phí theo gói. Mức phí được đặt là 50 đô la Mỹ cho gói đầu tiên (tối đa 1.000 giao dịch) và 40 đô la Mỹ cho gói thứ hai (trên 1.000 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 kế hoạch theo bảng giá, bạn có thể thiết lập một gói miễn phí cho một sản phẩm riêng lẻ (thay vì cho một gói API). Gói miễn phí có tính 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 số lần sử dụng.

Khi thiết lập gói thu phí trong miễn phí cho một sản phẩm API, bạn cần nêu rõ trong phần thông tin chi tiết về gói giá. Khoảng thời gian nhà phát triển có thể sử dụng tài nguyên do sản phẩm API cung cấp mà không mất phí. Khoảng thời gian này có thể dựa trên một trong các yếu tố sau:

• Thời lượng, tức là 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ố giao dịch liên quan đến sản phẩm API hoặc số 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 lại giao dịch.

Nếu khoảng thời gian thu phí trong miễn phí dựa trên số lượng, hãy chỉ định khoảng thời gian đó là một số đơn vị thu phí trong miễn phí. Ví dụ: sau đây là cách tạo gói giá trong đó có một gói thu phí trong miễn phí dựa trên số lượng 5.000 đơn vị (thông số kỹ thuật liên quan đến thu phí trong miễn phí đượ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