Konfigurasikan paket kartu tarif

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

Pengantar

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

Secara opsional, Anda dapat menentukan paket freemium untuk masing-masing produk (bukan untuk API) ) — Anda dapat melakukan ini hanya untuk rencana khusus produk.

Kapan biaya berulang ditagih dan paket paket direset?

Paket tarif dapat mencakup biaya berulang serta paket API (paket Volume Band dan Paket), keduanya melibatkan waktu tertentu saat biaya ditagih dan paket paket diatur ulang ke nol. Tujuan tabel berikut menjelaskan kapan biaya berulang ditagih dan jumlah paket direset. Jika aplikasi developer diblokir agar tidak melakukan panggilan API lebih lanjut karena batas transaksi, ini adalah waktu saat jumlah panggilan API direset ke nol dan aplikasi dapat mulai melakukan panggilan lagi.

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

Biaya berulang dan reset paket paket dilakukan pada tanggal satu setiap bulan (default).

Untuk pengulangan bulanan pada hari tertentu, buat rencana tarif menggunakan pengelolaan API dan menunjukkan hari dengan properti RecurringStartUnit, seperti yang dijelaskan di Membuat paket tarif menggunakan API.
  • Biaya berulang bukan nol ditetapkan ke Minggu
  • Paket Volume Berikat atau Paket
 Biaya berulang dan reset paket paket dilakukan setiap 7 hari setelah tarif developer tanggal mulai rencana.
  • Biaya berulang bukan nol ditetapkan ke Hari
  • Paket Volume Berikat atau Paket
 Biaya berulang dan reset paket paket dilakukan setiap X hari setelah tanggal mulai paket tarif developer.
  • Tidak ada (atau biaya berulang nol dolar)
  • Paket Volume Berikat atau Paket

Paket paket direset berdasarkan Dasar Agregasi yang ditentukan pada kartu tarif. Sebagai misalnya, jika developer memulai paket tarif pada tanggal 19 bulan tersebut, dan Dasarnya setiap 1 bulan, maka penggunaan paket direset setiap bulan pada tanggal 19.

Perhatikan bahwa tanggal mungkin tidak selalu sama. Misalnya, jika tarif dimulai pada 31 Desember, tanggal reset menjadi tanggal 28 di luar tahun kabisat Februari karena hanya ada 28 hari di bulan Februari. Tanggal 28 kemudian tetap menjadi hari reset selamanya.

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 akan dikenai tarif tetap untuk setiap transaksi.
Volume Dengan Tali Developer dikenai tarif tidak tetap, bergantung pada volume transaksi.
Bundles Developer akan dikenai biaya di muka dengan jumlah yang telah ditentukan untuk setiap paket transaksi. Developer akan dikenai jumlah yang ditetapkan, terlepas dari apakah paket tersebut digunakan sepenuhnya atau tidak.

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

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

Model Pengisian Daya Kolom Deskripsi
Semua Frekuensi penghitungan Periode 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 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 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 mengirim jumlah byte yang ditentukan).

Volume Dengan Tali Band Volume Satu atau beberapa rentang volume transaksi (atau berbasis atribut pelanggan) (setiap rentang disebut "pita volume") untuk model penagihan berband volume. Setiap band volume dapat diberi kecepatan. Tarif ini diterapkan ke semua transaksi dalam band volume yang berlaku. Tentukan batas atas band pertama, misalnya, hingga 1.000 (batas bawah preset ke nilai yang lebih besar dari 0).

Klik +Baru untuk menambahkan tali lain.

Biarkan batas atas pita akhir kosong 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 band volume di bagian Band Volume (>0-1000, dan 1000 dan lebih tinggi), Anda dapat memasukkan 0,15 untuk band volume >0-1000, dan 0,10 untuk band volume 1000 dan lebih tinggi. 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, tarifnya adalah $0,10 untuk setiap transaksi.

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

Klik +Baru untuk menambahkan paket tambahan. Anda harus menentukan batas atas untuk paket terakhir kecuali jika Anda ingin mengenakan biaya tetap kepada developer untuk transaksi tak 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 dari 0 hingga 1.000, dan lebih besar dari 1000 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 paket kedua $40. Developer dikenai harga paket yang berlaku terlepas dari jumlah transaksi yang mereka gunakan 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 di mana Anda menagih developer untuk setiap transaksi, Anda dapat menetapkan tarif paket tersebut berdasarkan atribut khusus, seperti jumlah byte yang ditransmisikan di backend yang dapat bervariasi per transaksi.

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

Edge Klasik (Private Cloud)

Untuk mengonfigurasi paket kartu tarif menggunakan UI Classic Edge:

  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 Spesifik Per Produk guna 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 gratis Produk API selama jangka waktu tertentu atau berdasarkan jumlah penggunaan.

    Masukkan informasi berikut:

    Kolom Deskripsi
    Produk Freemium?

    Tingkat periode bebas. Pilih salah satu tombol pilihan berikut:

    • Menurut Kuantitas. Periode gratis didasarkan pada kuantitas yang ditentukan dalam Volume kolom tersebut.
    • Menurut Durasi. Periode biaya didasarkan pada interval waktu yang ditentukan dalam Freemium Duration.
    • Mana pun yang lebih dulu. Periode gratis berakhir pada saat jumlah dalam bidang volume atau interval waktu di bidang Durasi Freemium tercapai, mana saja yang lebih dulu terjadi.
    • 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. Volumenya yang diukur untuk produk API. Masukkan angka volume, misalnya 5000. Hal ini berarti bahwa saat developer memulai paket, mereka tidak akan ditagih untuk 5.000 transaksi pertama (atau untuk 5.000 penggunaan pertama item terkait atribut khusus). Bidang ini adalah diaktifkan hanya jika Anda memilih "Menurut Kuantitas" atau "Mana yang lebih dulu" di kursus "Freemium" Produk?" kolom tersebut.
    Durasi Freemium

    Interval waktu saat developer tidak dikenai biaya. Masukkan angka dan pilih jangka waktu, misalnya, 1 Bulan. Ini berarti bahwa pengembang tidak ditagih selama 1 bulan. Kolom ini hanya diaktifkan jika Anda memilih "Menurut Durasi" atau "Mana yang lebih dulu" di "Produk freemium?" kolom tersebut.
  6. Pilih salah satu model pengisian daya berikut:
    • Tarif Tetap. Pada model ini, developer dikenai tarif tetap untuk setiap transaksi.
    • Volume Diikat. Dalam model ini, developer dikenai tarif tidak tetap bergantung pada volume transaksi.
    • Bundle. Dalam model ini, developer ditagih sejumlah uang yang telah ditetapkan (di muka) untuk setiap satu paket transaksi. Developer akan dikenai biaya sesuai jumlah yang ditetapkan, terlepas dari apakah paket tersebut digunakan sepenuhnya.

    Untuk model tarif tetap: Masukkan informasi berikut di bagian Harga di jendela Generic Rate Card (Kartu Tarif Umum):

    Kolom Deskripsi
    Operator (atau Organisasi)

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

    Negara operasional organisasi Anda. Bidang ini telah ditetapkan sebelumnya menggunakan Nilai kolom negara di profil organisasi.
    Tarif Tetap

    Tarif yang dikenakan untuk setiap transaksi. Masukkan angka desimal (maksimal empat angka desimal).

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

    Misalnya, jika Anda memasukkan 0,10, dan mata uangnya adalah dolar AS, pengembangnya 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 sejumlah byte yang ditentukan).

    Untuk model volume band: Jendela Kartu Tarif Generik menampilkan yang Anda gunakan untuk menentukan dasar agregasi dan menentukan "pita volume", yang rentang volume transaksi di mana Anda dapat menerapkan tarif yang berbeda.

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

    Masukkan informasi berikut di jendela Generic Tarif Card:

    Kolom Deskripsi
    Dasar Agregasi

    Periode waktu saat volume transaksi (atau transaksi khusus volume terkait atribut) digabungkan. Volume gabungan digunakan untuk mengidentifikasi {i>band volume<i} dan {i>tarif<i} yang akan diterapkan untuk setiap transaksi. Pilih jumlah bulan (1-12 bulan).

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

    Satu atau beberapa rentang volume transaksi (atau berbasis atribut pelanggan) (setiap rentang adalah "pita volume"). Setiap band volume dapat ditetapkan kecepatannya (Anda dapat menetapkan kecepatan ini di isian Band Volume di bagian Harga.) Tarif berlaku untuk semua transaksi di band volume yang berlaku. Tentukan batas atas band, misalnya, hingga 1000 (batas bawah ditetapkan ke lebih besar dari 0). Klik + untuk menambahkan pita kedua, misalnya, lebih besar dari 1000 hingga 2000. Klik + untuk menambahkan lebih banyak band. Anda dapat membiarkan batas atas pita terakhir kosong untuk mengindikasikan semua transaksi di atas level ini.
    Harga
    Operator (atau Organisasi)

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

    Negara operasional organisasi Anda. Bidang ini telah ditetapkan sebelumnya menggunakan Nilai kolom negara di Profil Organisasi.
    Mata Uang

    "Dasar" atau mata uang akuntansi yang digunakan organisasi Anda. Bidang ini adalah telah ditetapkan menggunakan nilai kolom Mata uang di Profil Organisasi, tetapi dapat berupa saya ubah di sini.
    Band Volume

    Frekuensi 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 kecepatan band volume menggunakan API (bukan UI). Untuk detailnya, lihat Mengonfigurasi jumlah tempat desimal untuk tarif paket tarif.

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

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

    Masukkan informasi berikut di jendela Generic Tarif Card:

    Kolom Deskripsi
    Dasar Agregasi

    Periode waktu saat developer dapat menggunakan paket transaksi (atau menggunakan paket berbasis atribut khusus). Pilih jumlah bulan (1-12 bulan). Sesudah periode ini, paket akan berakhir dan developer harus membeli paket tersebut (dan paket) untuk mencoba lagi perintah.

    Untuk mengetahui detail tentang kapan paket direset, lihat Kapan paket berulang biaya yang 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 ditetapkan harga (Anda menetapkan harga ini di kolom Bundle Size di bagian Pricing.) Tujuan harga berlaku untuk seluruh paket. Tentukan batas atas paket pertama, untuk misalnya, hingga 1000 (batas bawah ditetapkan ke lebih besar dari 0). Klik + untuk menambahkan paket kedua, misalnya, lebih besar dari 1.000 hingga 2.000. Klik + untuk menambahkan lebih banyak paket. Anda harus menentukan batas atas untuk paket terakhir, kecuali jika Anda ingin membebankan jumlah tetap kepada pengembang untuk transaksi tak terbatas dalam paket.
    Harga
    Operator (atau Organisasi)

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

    Negara operasional organisasi Anda. Bidang ini telah ditetapkan sebelumnya menggunakan Nilai kolom negara di Profil Organisasi.
    Mata Uang

    "Dasar" atau mata uang akuntansi yang digunakan organisasi Anda. Bidang ini adalah telah ditetapkan menggunakan nilai kolom Mata uang di Profil Organisasi, tetapi dapat berupa saya ubah di sini.
    Ukuran Paket (harga)

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

    Catatan: Anda dapat mengonfigurasi jumlah angka desimal yang dapat ditentukan untuk tarif paket menggunakan API (bukan UI). Untuk 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 dari 0 hingga 1000 paket, 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 $40. Developer akan dikenai harga paket yang berlaku terlepas dari jumlah transaksi yang mereka gunakan dalam paket (yaitu, developer dikenai harga paket segera setelah transaksi pertama dalam paket selesai.)
  7. Klik Terapkan dan Tutup untuk menyimpan detail kartu tarif dan kembali ke Paket Tarif Standar jendela.
  8. Untuk paket tarif khusus produk API, konfigurasi detail paket tarif untuk produk API tambahan, jika diperlukan.

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 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, band volume, atau paket.

Menetapkan model pengisian daya tetap

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

  • 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 tetap per unit (yang tidak didasarkan pada volume transaksi, seperti halnya untuk volume yang terikat atau memaketkan model pengisian daya).
  • 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 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 sejumlah byte yang ditentukan).
  • Unit awal aplikasi tarif (0). Ini berarti bahwa tarifnya diterapkan ke setiap transaksi, dimulai dengan transaksi pertama.

Lihat Paket tarif setelan konfigurasi detail untuk mengetahui daftar lengkap opsi detail paket tarif.

Misalnya, kode berikut membuat paket kartu tarif dengan model penagihan tetap. Tarifnya adalah ditetapkan sebesar $0,10 untuk setiap transaksi. Pembayaran jatuh tempo dalam 30 hari. (Detail terkait kartu tarif adalah highlighted.)

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

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

Selain tarif paket tarif, Anda menetapkan 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 (bukan tarif tetap per transaksi, seperti yang terjadi pada model pengisian daya tetap).
  • Batas waktu pembayaran (misalnya, 30 hari).
  • ID organisasi Anda.
  • "Dasar" atau mata uang akuntansi yang digunakan perusahaan Anda.
  • Jenis durasi dan durasi yang bersama-sama menentukan periode waktu saat volume transaksi (atau volume terkait atribut khusus) digabungkan. Hal ini juga disebut sebagai "basis agregasi". Volume transaksi diagregasi berdasarkan agregasi (untuk misalnya, 1 bulan) untuk menentukan pita 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 akan 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 sejumlah byte yang ditentukan).
  • Unit awal dan akhir band volume. Unit awal menentukan nilai batas band volume, dan unit akhir menentukan batas atas band volume. Sebagai misalnya, jika Anda menentukan unit awal 0 dan unit akhir 1000, pita volume mencakup hingga 1.000 transaksi dalam periode agregasi. Jika mata uangnya adalah dolar AS, periode agregasi adalah 1 bulan, dan tingkat untuk 1000 transaksi pertama adalah 0,15, developer dikenai $0,15 per transaksi untuk hingga 1000 transaksi dalam satu bulan.

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

    Jika Anda tidak menentukan unit akhir untuk pita volume akhir, tarif untuk pita tersebut adalah diterapkan ke semua transaksi setelah jumlah transaksi melampaui unit awal untuk {i>band<i} tersebut. Misalnya, unit awal untuk pita terakhir adalah 1000, dan Anda tidak perlu menentukan unit akhir untuk pita tersebut, tarif untuk pita diterapkan ke semua transaksi setelah 1.000 transaksi dalam periode agregasi.

Lihat Paket tarif setelan konfigurasi detail untuk mengetahui daftar lengkap opsi detail paket tarif.

Misalnya, contoh berikut membuat paket kartu tarif dengan model pengisian daya berbanding volume. Tujuan nilai tukar ditetapkan sebesar $0,15 untuk 1000 transaksi pertama, dan $0,10 untuk semua transaksi di atas 1000 transaksi. Dasar agregasi adalah 1 bulan. Pembayaran jatuh tempo dalam 30 hari. (Detail kartu tarif akan disorot.)

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

Menetapkan model pengisian daya yang dipaketkan

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

Misalnya, Anda menyiapkan dua paket, dengan ukuran paket pertama 1-ke-1000 transaksi, dan ukuran paket kedua adalah transaksi 1001-2000. Tarifnya adalah $50 untuk paket pertama dan $40 untuk paket kedua, dan dasar agregasinya adalah 1. Jika pengembang membeli paket kartu tarif untuk paket pertama, mereka membayar $50 (di muka) untuk 1.000 transaksi sebulan. Developer akan dikenai biaya sesuai jumlah yang ditetapkan, terlepas dari apakah paket tersebut digunakan sepenuhnya atau tidak. Setelah periode agregasi berakhir, masa berlaku paket akan berakhir. Jika developer ingin menggunakan paket sekali lagi, mereka harus membeli paket (dan paket) lagi.

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

  • Setiap paket tarif yang Anda tentukan ditujukan untuk paket (bukan untuk band volume).
  • Anda harus menentukan batas atas untuk paket terakhir, kecuali jika Anda ingin menagih pengembang dengan jumlah tetap untuk transaksi yang tak terbatas dalam paket terakhir.

Lihat Paket tarif setelan konfigurasi detail untuk mengetahui daftar lengkap opsi detail paket tarif.

Misalnya, kode berikut membuat paket kartu tarif dengan model pengisian daya yang dipaketkan. Tarifnya adalah ditetapkan sebesar $50 untuk paket pertama (hingga 1.000 transaksi), dan $40 untuk paket kedua (lebih dari dari 1000 dan hingga 2000 transaksi). Dasar agregasi 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 gratis kepada developer selama periode waktu atau berdasarkan jumlah penggunaannya.

Saat menyiapkan paket freemium untuk produk API, Anda menentukan dalam detail paket kartu tarif periode saat developer dapat menggunakan resource yang disediakan oleh produk API tanpa besar. Periode ini dapat didasarkan pada salah satu 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 unit freemium. Sebagai contoh berikut ini 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