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 harus 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 paket direset?

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

Jika rencananya... ...ini terjadi
  • Biaya berulang bukan nol ditetapkan ke Bulan
  • Paket Volume Banded atau Paket

Reset biaya berulang dan paket paket dilakukan 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 bukan nol ditetapkan ke Minggu
  • Paket Volume Banded atau Paket
Reset paket tarif dan biaya berulang dilakukan setiap 7 hari setelah tanggal mulai paket tarif developer.
  • Biaya berulang bukan nol ditetapkan ke Day
  • Paket Volume Banded atau Paket
Reset biaya berulang dan paket paket dilakukan setiap X hari setelah tanggal mulai paket tarif developer.
  • Tidak ada biaya berulang (atau nol dolar)
  • Paket Volume Banded atau Paket

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

Perhatikan bahwa hari dalam sebulan mungkin tidak selalu sama. Misalnya, jika rencana tarif dimulai pada 31 Desember, tanggal reset menjadi tanggal 28 dalam Februari, bukan tahun kabisat, karena hanya ada 28 hari pada bulan Februari. Tanggal 28 tetap menjadi hari reset setelahnya.

Mengonfigurasi paket kartu tarif menggunakan UI

Konfigurasikan paket kartu tarif, seperti yang dijelaskan di bawah.

Edge

Untuk mengonfigurasi paket kartu tarif, saat membuat atau mengedit paket tarif, pilih jenis paket tarif Kartu Tarif atau Kartu Tarif dan Pembagian Keuntungan dan di bagian Kartu Tarif, pilih salah satu model penagihan berikut:

Model pengisian daya Deskripsi
Tarif Tetap Developer dikenai tarif tetap untuk setiap transaksi.
Pita Volume Developer dikenai tarif variabel bergantung pada volume transaksi.
Bundles Developer dikenai biaya sejumlah yang ditetapkan di muka untuk setiap paket transaksi. Developer akan ditagih sebesar jumlah yang ditetapkan terlepas dari apakah paket digunakan sepenuhnya atau tidak.

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

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 khusus). Pilih jumlah bulan (1-24 bulan).
Tarif Tetap Tarif tetap Tarif yang dikenakan untuk setiap transaksi. Masukkan angka desimal (dengan maksimal empat angka desimal).

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 khusus seperti jumlah byte yang ditransmisikan dalam transaksi, developer dikenai biaya $0,10 untuk mengirimkan jumlah byte yang ditentukan).

Pita Volume Band Volume Satu atau beberapa rentang volume transaksi (atau berbasis atribut pelanggan) (setiap rentang adalah "band volume") untuk model penagihan volume. Setiap band volume dapat ditentukan tarifnya. Tarif ini diterapkan untuk semua transaksi dalam band volume yang berlaku. Tentukan batas atas band pertama, misalnya, hingga 1.000 (batas bawah preset untuk lebih besar dari 0).

Klik +Baru untuk menambahkan tali jam lain.

Kosongkan batas atas pita akhir untuk menunjukkan semua transaksi di atas level 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 pita volume di bagian Pita Volume (>0-1000, dan 1000 ke atas), Anda dapat memasukkan 0,15 untuk pita volume >0-1000, dan 0,10 untuk pita volume 1000 ke atas. Jika mata uang yang dipilih adalah dolar AS, nilai tukar untuk 1.000 transaksi pertama adalah $0,15 untuk setiap transaksi, dan untuk lebih dari 1.000 transaksi, nilai tukarnya adalah $0,10 untuk setiap transaksi.

Bundles Harga paket API Jumlah transaksi dalam paket (atau jumlah yang terkait dengan atribut khusus seperti jumlah total byte yang ditransmisikan dalam paket). Harga dapat ditetapkan untuk setiap paket. Harga berlaku untuk seluruh paket. Tentukan batas atas paket pertama, misalnya, maksimum 1.000 (batas bawah ditetapkan ke lebih besar dari 0).

Klik +Baru untuk menambahkan paket tambahan. Anda harus menentukan batas maksimum untuk paket terakhir, kecuali jika Anda ingin mengenakan biaya tetap kepada developer untuk transaksi yang tidak terbatas 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 yang lebih besar dari 0 hingga 1000, dan 40 untuk paket yang 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 dikenai biaya sesuai harga paket yang berlaku, terlepas dari jumlah transaksi yang digunakan dalam paket (yaitu, developer dikenai harga paket segera setelah transaksi pertama dalam paket selesai).

Jika Anda menentukan atribut khusus untuk produk API, Anda dapat mengonfigurasi parameter rating kustom untuk menagih developer aplikasi berdasarkan atribut khusus dalam setiap transaksi. Misalnya, jika Anda menyiapkan paket yang Anda gunakan untuk menagih developer untuk setiap transaksi, Anda dapat menetapkan tarif paket tersebut berdasarkan atribut khusus, seperti jumlah byte yang ditransmisikan di backend yang dapat bervariasi untuk setiap transaksi.

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

Edge Klasik (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 berisi 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 satu per satu.
    • 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 satu per satu.

    Jendela Kartu Tarif akan terbuka.

  5. Siapkan 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?

    Lamanya periode bebas. Pilih salah satu tombol pilihan berikut:

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

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

    Durasi Freemium

    Interval waktu saat developer tidak ditagih. Masukkan angka, lalu pilih jangka waktu, misalnya, 1 Bulan. Artinya, developer tidak dikenai biaya selama 1 bulan. Kolom ini hanya diaktifkan jika Anda memilih "Menurut Durasi" atau "Mana yang lebih dulu" di kolom "freemium Product?".

  6. Pilih salah satu model pengisian daya berikut:
    • Tarif Tetap. Dalam model ini, developer dikenai tarif tetap untuk setiap transaksi.
    • Pita Volume. Dalam model ini, developer dikenai tarif variabel bergantung pada volume transaksi.
    • Paket. Dalam model ini, developer dikenai biaya dengan jumlah yang ditetapkan (di awal) untuk setiap paket transaksi. Developer akan dikenai biaya sesuai jumlah 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 didasarkan pada atribut khusus seperti jumlah byte yang ditransmisikan dalam transaksi, developer dikenai biaya $0,10 untuk mengirimkan jumlah byte yang ditentukan).

    Untuk model volume yang ditetapkan: Jendela Kartu Tarif Generik menampilkan kolom tambahan yang Anda gunakan untuk menentukan dasar agregasi dan untuk menentukan "band volume", yaitu rentang volume transaksi yang tarifnya dapat Anda terapkan berbeda.

    Jenis paket ini biasanya disiapkan untuk mendorong developer agar menghasilkan volume yang lebih tinggi dengan menawarkan tarif diskon untuk band 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 khusus) digabungkan. Volume gabungan digunakan untuk mengidentifikasi band volume dan laju yang akan diterapkan pada setiap transaksi. Pilih jumlah bulan (1-12 bulan).

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

    Band Volume

    Satu atau beberapa rentang volume transaksi (atau berbasis atribut pelanggan) (setiap rentang adalah "band volume"). Setiap band volume dapat ditetapkan tarifnya (Anda dapat menyetel tarif ini pada kolom Band Volume di bagian Harga.) Tarif ini berlaku untuk semua transaksi dalam band volume yang berlaku. Tentukan batas atas band pertama, misalnya, hingga 1.000 (batas bawah ditetapkan ke lebih besar dari 0). Klik + untuk menambahkan band kedua, misalnya, lebih besar dari 1000 hingga 2000. Klik + untuk menambahkan tali lainnya. Anda dapat membiarkan batas atas pita akhir kosong untuk menunjukkan semua transaksi di atas level ini.

    Harga
    Operator (atau Organisasi)

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

    Negara

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

    Mata uang

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

    Band Volume

    Kecepatan untuk band volume. Anda menentukan tarif untuk setiap band volume. Masukkan angka desimal untuk setiap band (dengan maksimal empat angka desimal).

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

    Misalnya, jika Anda menentukan dua band volume di bagian Volume Band (>0-1000, serta 1000 dan yang lebih tinggi), Anda dapat memasukkan 0,15 untuk band volume >0-1000, dan 0,10 untuk band volume 1000 ke atas. Jika mata uang yang dipilih adalah dolar AS, nilai tukar untuk 1.000 transaksi pertama adalah $0,15 untuk setiap transaksi, dan untuk lebih dari 1.000 transaksi, nilai tukarnya adalah $0,10 untuk setiap transaksi.

    Untuk model yang dipaketkan: Jendela Kartu Tarif Umum menampilkan kolom tambahan yang Anda gunakan untuk menentukan dasar agregasi (periode waktu saat developer dapat menggunakan paket transaksi) dan untuk menentukan informasi terkait paket seperti ukuran paket.

    Masukkan informasi berikut di jendela Kartu Tarif Umum:

    Kolom Deskripsi
    Dasar Agregasi

    Periode waktu saat developer dapat menggunakan paket transaksi (atau menggunakan paket berbasis atribut khusus). Pilih jumlah bulan (1-12 bulan). Setelah periode ini, paket akan habis masa berlakunya dan developer harus membeli paket (beserta paket) lagi.

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

    Ukuran Paket

    Jumlah transaksi dalam paket (atau angka yang terkait dengan atribut khusus seperti jumlah total byte yang ditransmisikan dalam paket). Setiap paket dapat diberi harga (Anda dapat menetapkan harga ini dalam kolom Ukuran Paket di bagian Harga.) Harga ini berlaku untuk seluruh paket. Tentukan batas atas paket pertama, misalnya, hingga 1.000 (batas bawah ditetapkan ke lebih besar dari 0). Klik + untuk menambahkan paket kedua, misalnya, lebih besar dari 1000 hingga 2000. Klik + untuk menambahkan lebih banyak paket. Anda harus menentukan batas maksimum untuk paket terakhir, kecuali jika Anda ingin mengenakan biaya tetap kepada developer untuk transaksi tak terbatas dalam paket terakhir.

    Harga
    Operator (atau Organisasi)

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

    Negara

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

    Mata uang

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

    Ukuran Paket (harga)

    Harga 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 dari 0 hingga 1.000, dan lebih besar dari 1.000 hingga 2.000), Anda dapat memasukkan 50 untuk paket yang lebih besar dari 0 hingga 1.000, dan 40 untuk paket yang lebih besar dari 1.000 hingga 2.000. Jika mata uang yang dipilih adalah dolar AS, harga paket pertama adalah $50, dan harga paket kedua adalah $40. Developer akan dikenai biaya sesuai harga paket yang berlaku, terlepas dari jumlah transaksi yang digunakan dalam paket (yaitu, developer dikenai harga paket begitu transaksi pertama dalam paket tersebut selesai.)

  7. Klik Apply and Close untuk menyimpan detail kartu tarif dan kembali ke jendela Paket Tarif Standar.
  8. Untuk paket tarif khusus produk API, konfigurasikan detail paket tarif untuk produk API tambahan, sebagaimana diperlukan.

Mengonfigurasi paket kartu tarif menggunakan API

Konfigurasikan 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 detailnya di properti ratePlanDetails dalam isi permintaan dalam panggilan ke /organizations/{org_name}/monetization-packages/{package_id}/rate-plans. Apa yang Anda tentukan di properti ratePlanDetails, bergantung pada model pengisian daya yang Anda pilih: tarif tetap, volume yang digabungkan, atau paket.

Menentukan model pengisian daya tarif tetap

Untuk menerapkan model penagihan tarif tetap, Anda menentukan hal berikut dalam detail paket tarif:

  • Parameter rating yang menunjukkan bahwa paket tarif didasarkan pada transaksi (VOLUME) atau berdasarkan atribut khusus (misalnya, MINT_CUSTOM_ATTRIBUTE_1). VOLUME adalah defaultnya.
  • Jenis pengukuran (UNIT) yang menunjukkan bahwa tarif tersebut tetap per unit (artinya, tidak didasarkan pada volume transaksi, seperti yang berlaku untuk model pengisian daya volume yang digabungkan atau paket).
  • Batas waktu pembayaran (misalnya, 30 hari).
  • ID organisasi Anda.
  • "Dasar" atau mata uang 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 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 dikenai biaya $0,10 untuk setiap transaksi (atau jika didasarkan pada atribut khusus seperti jumlah byte yang ditransmisikan dalam transaksi, developer dikenai biaya $0,10 untuk mengirimkan jumlah byte yang ditentukan).
  • Unit awal aplikasi tarif (0). Hal ini berarti tarif diterapkan ke setiap transaksi, yang dimulai dengan transaksi pertama.

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

Misalnya, perintah berikut akan membuat paket kartu tarif dengan model penagihan tetap. Tarifnya ditetapkan sebesar $0,10 untuk setiap transaksi. Pembayaran akan 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 dengan band volume

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

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

  • Parameter rating yang menunjukkan bahwa paket tarif didasarkan pada transaksi (VOLUME) atau berdasarkan atribut khusus (misalnya, CUSTOM_ATTRIBUTE_1). VOLUME adalah defaultnya.
  • Jenis pengukuran (VOLUME) yang menunjukkan bahwa tarif didasarkan pada volume transaksi (artinya, ini bukan tarif tetap per transaksi, seperti halnya untuk model penagihan tarif tetap).
  • Batas waktu pembayaran (misalnya, 30 hari).
  • ID organisasi Anda.
  • "Dasar" atau mata uang akuntansi yang digunakan perusahaan Anda.
  • Jenis durasi dan durasi yang secara bersama-sama menentukan jangka waktu saat volume transaksi (atau volume terkait atribut khusus) digabungkan. Hal ini juga disebut "basis agregasi". Volume transaksi diagregasi berdasarkan agregasi (misalnya, 1 bulan) untuk menentukan band volume yang berlaku.
  • Penghitung agregasi yang digunakan untuk menentukan band 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 dikenai biaya $0,15 untuk setiap transaksi (atau jika didasarkan pada atribut khusus seperti jumlah byte yang ditransmisikan dalam transaksi, developer dikenai biaya $0,15 untuk mengirimkan jumlah byte yang ditentukan).
  • Satuan awal dan akhir band volume. Unit awal menentukan batas bawah band volume, dan unit akhir menentukan batas atas band volume. Misalnya, jika Anda menentukan satuan awal 0 dan satuan akhir 1.000, band volume mencakup hingga 1.000 transaksi dalam periode agregasi. Jika mata uangnya adalah dolar AS, periode agregasinya adalah 1 bulan dan tarif untuk 1.000 transaksi pertama adalah 0,15, developer akan dikenai biaya $0,15 per transaksi untuk maksimum 1.000 transaksi dalam sebulan.

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

    Jika Anda tidak menentukan unit akhir untuk band volume akhir, laju untuk band tersebut akan diterapkan ke semua transaksi setelah jumlah transaksi berada di atas unit awal untuk band tersebut. Misalnya, jika unit awal untuk band terakhir adalah 1000, dan Anda tidak menentukan satuan akhir untuk band tersebut, kecepatan untuk band ini akan diterapkan ke semua transaksi setelah 1000 transaksi dalam periode agregasi.

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

Misalnya, contoh berikut akan membuat paket kartu tarif dengan model pengisian daya berbasis volume. Tarifnya ditetapkan ke $0,15 untuk 1.000 transaksi pertama, dan $0,10 untuk semua transaksi di atas 1.000. Dasar agregasi adalah 1 bulan. Pembayaran akan 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 yang dipaketkan

Dalam model penagihan paket, developer membayar (di muka) untuk "paket" transaksi (atau untuk paket berdasarkan atribut khusus seperti jumlah byte yang dikirim). Anda menentukan tarif untuk setiap paket dan basis agregasi, yaitu jangka waktu saat developer dapat menggunakan paket tersebut.

Misalnya, Anda menyiapkan dua paket, dengan ukuran paket pertama adalah 1 hingga 1000 transaksi, dan ukuran paket kedua adalah transaksi 1001 hingga 2000. Tarifnya adalah $50 untuk paket pertama dan $40 untuk paket kedua, dan basis agregasinya adalah 1. Jika developer membeli paket kartu tarif untuk paket pertama, mereka membayar $50 (di muka) untuk 1.000 transaksi dalam sebulan. Developer akan ditagih sebesar jumlah yang ditetapkan terlepas dari apakah paket digunakan sepenuhnya atau tidak. Setelah periode agregasi berakhir, paket akan berakhir masa berlakunya. Jika ingin menggunakan paket lagi, developer harus membeli paket (dan paket) lagi.

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

  • Setiap paket tarif yang Anda tentukan adalah untuk paket (bukan untuk band volume).
  • Anda harus menentukan batas maksimum untuk paket terakhir, kecuali jika Anda ingin mengenakan biaya tetap kepada developer untuk transaksi yang tidak terbatas dalam paket terakhir.

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

Misalnya, contoh berikut akan membuat paket kartu tarif dengan model penagihan paket. Tarifnya ditetapkan sebesar $50 untuk paket pertama (hingga 1.000 transaksi), dan $40 untuk paket kedua (lebih dari 1.000 dan maksimum 2.000 transaksi). Dasar agregasi adalah 1 bulan. Pembayaran akan 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 yang menggunakan API

Dalam paket kartu tarif, Anda dapat menyiapkan paket freemium untuk setiap produk (bukan 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 menetapkan dalam detail paket tarif untuk periode saat developer dapat menggunakan resource yang disediakan oleh produk API secara gratis. Periode dapat didasarkan pada salah satu dari hal berikut:

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

Jika periode freemium didasarkan pada kuantitas, tentukan sebagai jumlah satuan freemium. Misalnya, perintah berikut akan 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