Konfigurasikan paket kartu tarif

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Pengantar

Dalam paket kartu tarif, developer dikenai biaya untuk setiap transaksi. Untuk jenis paket ini, Anda perlu memberikan detail tambahan, seperti model pengisian daya dan harga untuk model pengisian daya.

Secara opsional, Anda dapat menentukan paket freemium untuk setiap produk (bukan untuk paket API) — Anda hanya dapat melakukannya untuk paket khusus produk.

Kapan biaya berulang ditagih dan paket bundling direset?

Paket tarif dapat mencakup biaya berulang serta paket API (paket Volume Bertingkat dan Paket), yang keduanya melibatkan waktu tertentu saat biaya ditagih dan paket direset ke nol. Tabel berikut menjelaskan kapan biaya berulang ditagih dan jumlah paket direset. Jika aplikasi developer diblokir untuk melakukan panggilan API lebih lanjut karena telah mencapai batas transaksi tertentu, saat itulah jumlah panggilan API direset ke nol dan aplikasi dapat mulai melakukan panggilan lagi.

Jika paket memiliki... ...hal ini terjadi
  • Biaya berulang non-nol ditetapkan ke Bulan
  • Paket Volume atau Paket Gabungan

Reset biaya berulang dan paket terjadi pada tanggal satu setiap bulan (default).

Untuk pengulangan bulanan pada hari tertentu, buat paket tarif menggunakan API pengelolaan dan tunjukkan hari dengan properti RecurringStartUnit, seperti yang dijelaskan dalam Membuat paket tarif menggunakan API.
  • Biaya berulang non-nol ditetapkan ke Week
  • Paket Volume atau Paket Gabungan
 Biaya berulang dan reset paket terjadi setiap 7 hari setelah tanggal mulai paket tarif developer.
  • Biaya berulang non-nol ditetapkan ke Hari
  • Paket Volume atau Paket Gabungan
 Reset paket dan biaya berulang terjadi setiap X hari setelah tanggal mulai paket tarif developer.
  • Tidak ada biaya berulang (atau biaya berulang nol dolar)
  • Paket Volume atau Paket Gabungan

Paket gabungan direset berdasarkan Basis Agregasi yang ditentukan pada kartu tarif. Misalnya, jika developer memulai paket tarif pada tanggal 19 dalam sebulan, dan Basis Agregasi adalah setiap 1 bulan, maka penggunaan paket akan direset setiap bulan pada tanggal 19.

Perhatikan bahwa tanggal dalam bulan mungkin tidak selalu sama. Misalnya, jika paket tarif dimulai pada 31 Desember, tanggal reset menjadi 28 Februari pada tahun non-kabisat karena hanya ada 28 hari pada bulan Februari. Maka, tanggal 28 akan tetap menjadi hari reset seterusnya.

Mengonfigurasi paket kartu tarif menggunakan UI

Konfigurasi paket kartu tarif, seperti yang dijelaskan di bawah.

Edge

Untuk mengonfigurasi rencana kartu tarif, saat membuat atau mengedit rencana tarif, pilih jenis rencana tarif Kartu Tarif atau Kartu Tarif dan Pembagian Pendapatan, lalu di bagian Kartu Tarif, pilih salah satu model pengenaan biaya berikut:

Model pengisian daya Deskripsi
Tarif Tetap Developer dikenai biaya tetap untuk setiap transaksi.
Volume dengan Tali Developer dikenai tarif variabel, bergantung pada volume transaksi.
Bundles Developer dikenai biaya sejumlah tertentu di muka untuk setiap paket transaksi. Developer dikenai biaya sejumlah yang ditetapkan, terlepas dari apakah paket digunakan sepenuhnya atau tidak.

Catatan: Opsi ini tidak tersedia jika Anda memilih Kartu Tarif dan Pembagian Pendapatan.

Kemudian, konfigurasikan informasi berikut berdasarkan model pengisian daya yang dipilih.

Model Pengisian Daya Kolom Deskripsi
Semua Frekuensi penghitungan Jangka waktu penghitungan volume transaksi (atau volume terkait atribut kustom). Pilih jumlah bulan (1-24 bulan).
Tarif Tetap Tarif tetap Tarif yang dikenakan untuk setiap transaksi. Masukkan angka desimal (dengan maksimal empat angka di belakang koma).

Catatan: Anda dapat mengonfigurasi jumlah tempat desimal yang dapat ditentukan untuk tarif yang dikenakan menggunakan API (bukan UI). Untuk mengetahui detailnya, lihat Mengonfigurasi jumlah tempat desimal untuk tarif paket tarif.

Misalnya, jika Anda memasukkan 0,10, dan mata uangnya adalah dolar AS, developer akan ditagih $0,10 untuk setiap transaksi (atau jika berdasarkan atribut kustom seperti jumlah byte yang ditransmisikan dalam transaksi, developer akan ditagih $0,10 untuk mentransmisikan jumlah byte yang ditentukan).

Volume dengan Tali Tali Jam Satu atau beberapa rentang volume transaksi (atau berbasis atribut pelanggan) (setiap rentang adalah "rentang volume") untuk model pengenaan biaya berbasis rentang volume. Setiap rentang volume dapat diberi tarif. Tarif ini diterapkan ke semua transaksi dalam rentang volume yang berlaku. Tentukan batas atas rentang pertama, misalnya, hingga 1000 (batas bawah telah ditetapkan ke lebih besar dari 0).

Klik +Baru untuk menambahkan rentang lainnya.

Biarkan batas atas rentang akhir kosong untuk menunjukkan semua transaksi di atas tingkat ini.

Catatan: Anda dapat mengonfigurasi jumlah tempat desimal yang dapat ditentukan untuk tarif yang dikenakan menggunakan API (bukan UI). Untuk mengetahui detailnya, lihat Mengonfigurasi jumlah tempat desimal untuk tarif paket tarif.

Misalnya, jika Anda menentukan dua rentang volume di bagian Rentang Volume (>0-1000, dan 1000 ke atas), Anda dapat memasukkan 0,15 untuk rentang volume >0-1000, dan 0,10 untuk rentang volume 1000 ke atas. Jika mata uang yang dipilih adalah dolar AS, tarif untuk 1.000 transaksi pertama adalah $0,15 untuk setiap transaksi, dan untuk lebih dari 1.000 transaksi, tarifnya adalah $0,10 untuk setiap transaksi.

Bundles Harga paket API Jumlah transaksi dalam bundle (atau jumlah yang terkait dengan atribut kustom seperti jumlah total byte yang ditransmisikan dalam bundle). Setiap paket dapat diberi harga. Harga berlaku untuk seluruh paket. Tentukan batas atas paket pertama, misalnya, hingga 1000 (batas bawah telah ditetapkan ke lebih besar dari 0).

Klik +Baru untuk menambahkan paket tambahan. Anda harus menentukan batas atas untuk paket terakhir, kecuali jika Anda ingin menagih developer dengan jumlah tetap untuk transaksi tanpa batas dalam paket terakhir.

Catatan: Anda dapat mengonfigurasi jumlah tempat desimal yang dapat ditentukan untuk tarif yang dikenakan menggunakan API (bukan UI). Untuk mengetahui detailnya, lihat Mengonfigurasi jumlah tempat desimal untuk tarif paket tarif.

Misalnya, jika Anda menentukan dua paket di bagian Ukuran Paket (lebih besar dari 0 hingga 1000, dan lebih besar dari 1000 hingga 2000), Anda dapat memasukkan 50 untuk paket lebih besar dari 0 hingga 1000, dan 40 untuk paket lebih besar dari 1000 hingga 2000. Jika mata uang yang dipilih adalah dolar AS, harga untuk paket pertama adalah $50, dan untuk paket kedua, harganya adalah $40. Developer akan ditagih harga paket yang berlaku, terlepas dari jumlah transaksi yang mereka gunakan dalam paket (yaitu, developer akan ditagih harga paket segera setelah transaksi pertama dalam paket selesai).

Jika Anda menentukan atribut kustom untuk produk API, Anda dapat mengonfigurasi parameter rating kustom untuk menagih developer aplikasi berdasarkan atribut kustom dalam setiap transaksi. Misalnya, jika Anda menyiapkan paket yang membebankan biaya kepada developer untuk setiap transaksi, Anda dapat menetapkan tarif untuk paket berdasarkan atribut kustom, seperti jumlah byte yang dikirimkan di backend yang dapat bervariasi per transaksi.

Dalam hal ini, pilih Gunakan parameter rating kustom dan pilih atribut kustom dari daftar drop-down. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi paket tarif dengan atribut kustom.

Classic Edge (Private Cloud)

Untuk mengonfigurasi paket kartu tarif menggunakan UI Edge Klasik:

  1. Ikuti langkah-langkah untuk membuat paket tarif.
  2. Pilih Kartu Tarif di drop-down Jenis Paket Tarif untuk mengonfigurasi model pendapatan.
  3. Jika paket API yang dipilih mencakup beberapa produk API, pilih salah satu opsi berikut:

    Catatan: Jika paket API menyertakan satu produk API, Anda dapat melewati langkah ini.

    • Paket Khusus Produk untuk mengonfigurasi detail paket tarif untuk setiap produk API secara terpisah.
    • Paket Umum untuk Semua Produk guna mengonfigurasi detail paket tarif untuk semua produk API.
  4. Klik Kartu Tarif untuk paket tarif umum atau untuk setiap paket tarif khusus produk API.

    Catatan: Saat mengonfigurasi paket khusus produk API, Anda harus mengonfigurasi paket kartu tarif untuk setiap produk API secara terpisah.

    Jendela Kartu Tarif akan terbuka.

  5. Menyiapkan paket freemium untuk produk API. Paket freemium menawarkan penggunaan produk API secara gratis kepada developer selama jangka waktu tertentu atau berdasarkan jumlah penggunaan.

    Masukkan informasi berikut:

    Kolom Deskripsi
    Produk Freemium?

    Durasi periode bebas. Pilih salah satu tombol pilihan berikut:

    • Menurut Jumlah. Periode gratis didasarkan pada jumlah yang ditentukan di kolom Volume.
    • Menurut Durasi. Periode biaya didasarkan pada interval waktu yang ditentukan di kolom Durasi Freemium.
    • Mana saja yang lebih dulu. Periode gratis berakhir saat jumlah di kolom Volume atau interval waktu di kolom Durasi Freemium tercapai, mana saja yang terjadi lebih dulu.
    • Tidak. Ini bukan paket freemium. Ini adalah defaultnya.
    Volume Freemium

    Volume transaksi (atau volume yang terkait dengan atribut kustom yang dicatat dalam kebijakan pencatatan transaksi) yang tidak dikenai biaya untuk developer. Volume diukur untuk produk API. Masukkan angka volume, seperti 5000. Artinya, saat developer memulai paket, mereka tidak akan ditagih untuk 5.000 transaksi pertama (atau untuk 5.000 penggunaan pertama item terkait atribut kustom). Kolom ini diaktifkan hanya jika Anda memilih "Menurut Kuantitas" atau "Mana saja yang lebih dulu" di kolom "Produk Freemium?".
    Durasi Freemium

    Interval waktu saat developer tidak dikenai biaya. Masukkan angka dan pilih jangka waktu, misalnya, 1 Bulan. Artinya, developer tidak dikenai biaya selama 1 bulan. Kolom ini hanya diaktifkan jika Anda memilih "By Duration" atau "Whichever comes first" di kolom "freemium Product?".
  6. Pilih salah satu model pengisian daya berikut:
    • Tarif Tetap. Dalam model ini, developer dikenai tarif tetap untuk setiap transaksi.
    • Volume yang Dikelompokkan. Dalam model ini, developer dikenai biaya dengan tarif variabel, bergantung pada volume transaksi.
    • Paket. Dalam model ini, developer dikenai biaya dalam jumlah tetap (di muka) untuk setiap kumpulan transaksi. Developer dikenai biaya sejumlah yang ditetapkan, terlepas dari apakah paket digunakan sepenuhnya atau tidak.

    Untuk model tarif tetap: Masukkan informasi berikut di bagian Harga pada jendela Kartu Tarif Umum:

    Kolom Deskripsi
    Operator (atau Organisasi)

    Nama organisasi Anda. Kolom ini telah ditetapkan sebelumnya menggunakan nilai kolom Operator (atau Organisasi) di profil organisasi.
    Negara

    Negara tempat organisasi Anda beroperasi. Kolom ini telah ditetapkan sebelumnya menggunakan nilai kolom Negara di profil organisasi.
    Tarif Tetap

    Tarif yang dikenakan untuk setiap transaksi. Masukkan angka desimal (dengan maksimal empat angka di belakang koma).

    Catatan: Anda dapat mengonfigurasi jumlah tempat desimal yang dapat ditentukan untuk tarif yang dikenakan menggunakan API (bukan UI). Untuk mengetahui detailnya, lihat Mengonfigurasi jumlah tempat desimal untuk tarif paket tarif.

    Misalnya, jika Anda memasukkan 0,10, dan mata uangnya adalah dolar AS, developer akan dikenai biaya $0,10 untuk setiap transaksi (atau jika berdasarkan atribut kustom seperti jumlah byte yang ditransmisikan dalam transaksi, developer akan dikenai biaya $0,10 untuk mentransmisikan jumlah byte yang ditentukan).

    Untuk model rentang volume: Jendela Kartu Tarif Umum menampilkan kolom tambahan yang Anda gunakan untuk menentukan dasar penggabungan dan untuk menentukan "rentang volume", yaitu rentang volume transaksi yang dapat Anda terapkan tarif berbeda.

    Jenis paket ini biasanya disiapkan untuk mendorong developer menghasilkan volume yang lebih tinggi dengan menawarkan tarif diskon untuk rentang volume yang lebih tinggi.

    Masukkan informasi berikut di jendela Kartu Tarif Umum:

    Kolom Deskripsi
    Dasar Agregasi

    Periode waktu saat volume transaksi (atau volume terkait atribut kustom) digabungkan. Volume gabungan digunakan untuk mengidentifikasi rentang volume dan tarif yang akan diterapkan ke setiap transaksi. Pilih jumlah bulan (1-12 bulan).

    Untuk mengetahui detail tentang kapan paket direset, lihat Kapan biaya berulang ditagih dan paket direset?
    Rentang Volume

    Satu atau beberapa rentang volume transaksi (atau berbasis atribut pelanggan) (setiap rentang adalah "rentang volume"). Setiap rentang volume dapat diberi tarif (Anda menetapkan tarif ini di kolom Rentang Volume di bagian Harga.) Tarif ini diterapkan ke semua transaksi dalam rentang volume yang berlaku. Tentukan batas atas rentang pertama, misalnya, hingga 1000 (batas bawah telah ditetapkan ke lebih besar dari 0). Klik + untuk menambahkan rentang kedua, misalnya, lebih besar dari 1000 hingga 2000. Klik + untuk menambahkan rentang lainnya. Anda dapat mengosongkan batas atas rentang akhir untuk menunjukkan semua transaksi di atas tingkat ini.
    Harga
    Operator (atau Organisasi)

    Nama organisasi Anda. Kolom ini telah ditetapkan sebelumnya menggunakan nilai kolom Operator (atau Organisasi) di Profil Organisasi.
    Negara

    Negara tempat organisasi Anda beroperasi. Kolom ini telah ditetapkan sebelumnya menggunakan nilai kolom Negara di Profil Organisasi.
    Mata Uang

    Mata uang "dasar" atau akuntansi yang digunakan organisasi Anda. Kolom ini telah ditetapkan menggunakan nilai kolom Mata Uang di Profil Organisasi, tetapi dapat diubah di sini.
    Tali Jam Pintar

    Tarif untuk rentang volume. Anda menentukan tarif untuk setiap rentang volume. Masukkan angka desimal untuk setiap rentang (dengan maksimal empat angka di belakang koma).

    Catatan: Anda dapat mengonfigurasi jumlah tempat desimal yang dapat ditentukan untuk tarif rentang volume menggunakan API (bukan UI). Untuk mengetahui detailnya, lihat Mengonfigurasi jumlah tempat desimal untuk tarif paket tarif.

    Misalnya, jika Anda menentukan dua rentang volume di bagian Rentang Volume (>0-1000, dan 1000 ke atas), Anda dapat memasukkan 0,15 untuk rentang volume >0-1000 dan 0,10 untuk rentang volume 1000 ke atas. Jika mata uang yang dipilih adalah dolar AS, tarif untuk 1.000 transaksi pertama adalah $0,15 untuk setiap transaksi, dan untuk lebih dari 1.000 transaksi, tarifnya adalah $0,10 untuk setiap transaksi.

    Untuk model gabungan: Jendela Kartu Tarif Umum menampilkan kolom tambahan yang Anda gunakan untuk menentukan dasar penggabungan (jangka waktu saat developer dapat menggunakan kumpulan transaksi) dan untuk menentukan informasi terkait gabungan seperti ukuran gabungan.

    Masukkan informasi berikut di jendela Kartu Tarif Umum:

    Kolom Deskripsi
    Dasar Agregasi

    Periode waktu saat developer dapat menggunakan kumpulan transaksi (atau menggunakan kumpulan berbasis atribut kustom). Pilih jumlah bulan (1-12 bulan). Setelah periode ini, paket akan berakhir dan developer harus membeli paket (dan paket gabungan) lagi.

    Untuk mengetahui detail tentang kapan paket direset, lihat Kapan biaya berulang ditagih dan paket direset?
    Ukuran Paket

    Jumlah transaksi dalam bundle (atau jumlah yang terkait dengan atribut kustom seperti jumlah total byte yang ditransmisikan dalam bundle). Setiap paket dapat diberi harga (Anda menetapkan harga ini di kolom Ukuran Paket pada bagian Harga.) Harga berlaku untuk seluruh paket. Tentukan batas atas paket pertama, misalnya, hingga 1000 (batas bawah telah ditetapkan ke lebih besar dari 0). Klik + untuk menambahkan paket kedua, misalnya, lebih dari 1.000 hingga 2.000. Klik + untuk menambahkan lebih banyak paket. Anda harus menentukan batas atas untuk paket terakhir, kecuali jika Anda ingin menagih developer dengan jumlah tetap untuk transaksi tanpa batas dalam paket terakhir.
    Harga
    Operator (atau Organisasi)

    Nama organisasi Anda. Kolom ini telah ditetapkan sebelumnya menggunakan nilai kolom Operator (atau Organisasi) di Profil Organisasi.
    Negara

    Negara tempat organisasi Anda beroperasi. Kolom ini telah ditetapkan sebelumnya menggunakan nilai kolom Negara di Profil Organisasi.
    Mata Uang

    Mata uang "dasar" atau akuntansi yang digunakan organisasi Anda. Kolom ini telah ditetapkan menggunakan nilai kolom Mata Uang di Profil Organisasi, tetapi dapat diubah di sini.
    Ukuran Paket (harga)

    Harga untuk paket. Anda menentukan harga untuk setiap paket. Masukkan angka desimal (dengan maksimal empat angka di belakang koma).

    Catatan: Anda dapat mengonfigurasi jumlah tempat desimal yang dapat ditentukan untuk tarif paket menggunakan API (bukan UI). Untuk mengetahui detailnya, lihat Mengonfigurasi jumlah tempat desimal untuk tarif paket tarif.

    Misalnya, jika Anda menentukan dua paket di bagian Ukuran Paket (lebih besar dari 0 hingga 1.000, dan lebih besar dari 1.000 hingga 2.000), Anda dapat memasukkan 50 untuk paket lebih besar dari 0 hingga 1.000, dan 40 untuk paket lebih besar dari 1.000 hingga 2.000. Jika mata uang yang dipilih adalah dolar AS, harga untuk paket pertama adalah $50, dan untuk paket kedua, harganya adalah $40. Developer dikenai biaya paket yang berlaku terlepas dari jumlah transaksi yang mereka gunakan dalam paket (yaitu, developer dikenai biaya paket segera setelah transaksi pertama dalam paket selesai.)
  7. Klik Terapkan dan Tutup untuk menyimpan detail kartu tarif dan kembali ke jendela Paket Tarif Standar.
  8. Untuk paket tarif khusus produk API, konfigurasi detail paket tarif untuk produk API tambahan, sesuai kebutuhan.

Mengonfigurasi paket kartu tarif menggunakan API

Konfigurasi detail paket kartu tarif menggunakan API, seperti yang dijelaskan di bagian berikut.

Menentukan detail paket kartu tarif menggunakan API

Anda menentukan detail paket kartu tarif saat membuat paket tarif. Anda menentukan detail di properti ratePlanDetails dalam isi permintaan saat melakukan panggilan ke /organizations/{org_name}/monetization-packages/{package_id}/rate-plans. Yang Anda tentukan di properti ratePlanDetails, bergantung pada model pengisian daya yang Anda pilih: tarif tetap, volume berjenjang, atau paket.

Menentukan model pengisian daya tarif tetap

Untuk menerapkan model pengisian daya tarif datar, Anda menentukan hal berikut dalam detail paket tarif:

  • Parameter rating yang menunjukkan bahwa paket tarif didasarkan pada transaksi (VOLUME) atau berdasarkan atribut kustom (misalnya, MINT_CUSTOM_ATTRIBUTE_1). VOLUME adalah nilai default.
  • Jenis pengukuran (UNIT) yang menunjukkan bahwa tarifnya tetap per unit (yaitu, tidak didasarkan pada volume transaksi, seperti halnya model pengenaan biaya paket atau berdasarkan volume).
  • Periode jatuh tempo pembayaran (misalnya, 30 hari).
  • ID organisasi Anda.
  • Mata uang "dasar" atau akuntansi yang digunakan perusahaan Anda.
  • Tarif paket tarif yang memberikan detail tentang cara penghitungan tarif. Karena model pengisian daya didasarkan pada tarif tetap, Anda hanya perlu menentukan satu tarif paket tarif.

Dalam tarif paket tarif, Anda menentukan:

  • Jenis tarif paket tarif (RATECARD).
  • Tarif untuk paket. Misalnya, jika Anda menentukan 0,10, dan mata uangnya adalah dolar AS, developer akan ditagih $0,10 untuk setiap transaksi (atau jika berdasarkan atribut kustom seperti jumlah byte yang ditransmisikan dalam transaksi, developer akan ditagih $0,10 untuk mentransmisikan jumlah byte yang ditentukan).
  • Unit awal penerapan tarif (0). Artinya, tarif diterapkan ke setiap transaksi, dimulai dengan transaksi pertama.

Lihat Setelan konfigurasi detail paket tarif untuk mengetahui daftar lengkap opsi detail paket tarif.

Misalnya, berikut cara membuat paket kartu tarif dengan model pengisian daya tetap. Tarif ditetapkan sebesar $0,10 untuk setiap transaksi. Pembayaran jatuh tempo dalam 30 hari. (Detail terkait kartu tarif ditandai.)

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

Menentukan model pengisian daya berband volume

Dalam model rentang volume, Anda menentukan detail paket tarif yang mencakup satu atau beberapa tarif paket, yang masing-masing tarif berlaku untuk "rentang volume", yaitu rentang volume transaksi (atau rentang berdasarkan atribut kustom seperti jumlah byte yang ditransmisikan). Jenis paket ini biasanya disiapkan untuk mendorong developer menghasilkan volume yang lebih tinggi dengan menawarkan tarif diskon untuk rentang volume yang lebih tinggi.

Selain tarif paket tarif, Anda menentukan hal berikut dalam detail paket tarif:

  • Parameter rating yang menunjukkan bahwa paket tarif didasarkan pada transaksi (VOLUME) atau berdasarkan atribut kustom (misalnya, CUSTOM_ATTRIBUTE_1). VOLUME adalah nilai default.
  • Jenis pengukuran (VOLUME) yang menunjukkan bahwa tarif didasarkan pada volume transaksi (yaitu, bukan tarif tetap per transaksi, seperti halnya model penagihan tarif tetap).
  • Periode jatuh tempo pembayaran (misalnya, 30 hari).
  • ID organisasi Anda.
  • Mata uang "dasar" atau akuntansi yang digunakan perusahaan Anda.
  • Durasi dan jenis durasi yang bersama-sama menentukan jangka waktu saat volume transaksi (atau volume terkait atribut kustom) diagregasi. Hal ini juga disebut sebagai "dasar penggabungan". Volume transaksi digabungkan berdasarkan basis penggabungan (misalnya, 1 bulan) untuk menentukan rentang volume yang berlaku.
  • Penghitung agregasi yang digunakan untuk menentukan rentang volume yang berlaku.

Untuk setiap tarif paket tarif, Anda menentukan:

  • Jenis tarif paket tarif (RATECARD).
  • Tarif untuk paket. Misalnya, jika Anda menentukan 0,10, dan mata uangnya adalah dolar AS, developer akan ditagih $0,15 untuk setiap transaksi (atau jika berdasarkan atribut kustom seperti jumlah byte yang dikirim dalam transaksi, developer akan ditagih $0,15 untuk mengirimkan jumlah byte yang ditentukan).
  • Unit awal dan akhir rentang volume. Unit awal menentukan batas bawah rentang volume, dan unit akhir menentukan batas atas rentang volume. Misalnya, jika Anda menentukan unit awal 0 dan unit akhir 1000, rentang volume mencakup hingga 1000 transaksi dalam periode agregasi. Jika mata uangnya adalah dolar AS, periode agregasi adalah 1 bulan, dan tarif untuk 1.000 transaksi pertama adalah 0,15, developer akan dikenai biaya $0,15 per transaksi hingga 1.000 transaksi dalam sebulan.

    Untuk mengetahui detail tentang kapan paket direset, lihat Kapan biaya berulang ditagih dan paket direset?

    Jika Anda tidak menentukan unit akhir untuk rentang volume akhir, tarif untuk rentang tersebut akan diterapkan ke semua transaksi setelah jumlah transaksi melebihi unit awal untuk rentang tersebut. Misalnya, jika unit awal untuk rentang terakhir adalah 1.000, dan Anda tidak menentukan unit akhir untuk rentang tersebut, tarif untuk rentang tersebut akan diterapkan ke semua transaksi setelah 1.000 transaksi dalam periode agregasi.

Lihat Setelan konfigurasi detail paket tarif untuk mengetahui daftar lengkap opsi detail paket tarif.

Misalnya, berikut membuat paket kartu tarif dengan model pengisian daya berjenjang volume. Tarifnya ditetapkan sebesar $0,15 untuk 1.000 transaksi pertama, dan $0,10 untuk semua transaksi di atas 1.000. Dasar penggabungannya adalah 1 bulan. Pembayaran jatuh tempo dalam 30 hari. (Detail kartu tarif ditandai.)

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

Menentukan model pengisian daya gabungan

Dalam model pengisian daya yang dibundel, developer membayar (di muka) untuk "paket" transaksi (atau untuk paket berdasarkan atribut kustom seperti jumlah byte yang ditransmisikan). Anda menentukan tarif untuk setiap paket dan basis agregasi, yaitu jangka waktu saat developer dapat menggunakan paket.

Misalnya, Anda menyiapkan dua paket, dengan ukuran paket pertama adalah 1 hingga 1.000 transaksi, dan ukuran paket kedua adalah 1.001 hingga 2.000 transaksi. Tarifnya adalah $50 untuk paket pertama dan $40 untuk paket kedua, dan basis penggabungannya adalah 1. Jika developer membeli paket kartu tarif untuk paket pertama, dia membayar $50 (di muka) untuk 1.000 transaksi dalam sebulan. Developer dikenai biaya sejumlah yang ditetapkan, terlepas dari apakah paket digunakan sepenuhnya atau tidak. Setelah periode penggabungan berakhir, paket akan berakhir. Jika developer ingin menggunakan paket lagi, mereka harus membeli paket (dan bundel) lagi.

Apa yang Anda tentukan dalam detail paket tarif pada dasarnya sama dengan yang Anda tentukan dalam detail paket tarif untuk model pengisian daya dengan rentang volume. Perbedaannya adalah sebagai berikut:

  • Setiap paket tarif yang Anda tentukan adalah untuk paket (bukan untuk rentang volume).
  • Anda harus menentukan batas atas untuk paket terakhir, kecuali jika Anda ingin mengenakan biaya dalam jumlah tetap kepada developer untuk transaksi tanpa batas dalam paket terakhir.

Lihat Setelan konfigurasi detail paket tarif untuk mengetahui daftar lengkap opsi detail paket tarif.

Misalnya, berikut membuat paket kartu tarif dengan model pengisian daya gabungan. Tarif ditetapkan sebesar $50 untuk paket pertama (hingga 1.000 transaksi), dan $40 untuk paket kedua (lebih dari 1.000 dan hingga 2.000 transaksi). Dasar penggabungannya adalah 1 bulan. Pembayaran jatuh tempo dalam 30 hari.

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

Menentukan paket freemium untuk setiap produk menggunakan API

Dalam paket kartu tarif, Anda dapat menyiapkan paket freemium untuk setiap produk (bukan untuk paket API). Paket freemium menawarkan penggunaan produk API secara gratis kepada developer selama jangka waktu tertentu atau berdasarkan jumlah penggunaan.

Saat menyiapkan paket freemium untuk produk API, Anda menentukan periode dalam detail paket kartu tarif saat developer dapat menggunakan resource yang disediakan oleh produk API tanpa biaya. Periode dapat didasarkan pada salah satu hal berikut:

  • Durasi, yaitu waktu antara tanggal mulai berlaku dan tanggal akhir.
  • Jumlah, seperti jumlah transaksi yang melibatkan produk API atau volume yang terkait dengan atribut kustom yang dicatat dalam kebijakan pencatatan transaksi.

Jika periode freemium didasarkan pada kuantitas, tentukan sebagai jumlah unit freemium. Misalnya, kode berikut membuat paket kartu tarif dengan paket freemium berdasarkan volume 5.000 unit (spesifikasi terkait freemium ditandai).

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