API penagihan terukur marketplace - FAQ

Setelah pelanggan berlangganan layanan SaaS, Aplikasi Azure dengan paket Aplikasi Terkelola, atau penawaran aplikasi Kubernetes dengan penagihan terukur, Anda akan melacak konsumsi untuk setiap dimensi penagihan yang digunakan. Jika konsumsi melebihi jumlah yang disertakan yang ditetapkan untuk jangka waktu yang dipilih oleh pelanggan, layanan Anda akan menampilkan kejadian penggunaan ke Microsoft.

Untuk penawaran SaaS, aplikasi terkelola dan penawaran aplikasi Kubernetes

Seberapa sering layanan diharapkan untuk menampilkan penggunaan?

Idealnya, Anda diharapkan untuk menampilkan penggunaan setiap jam selama satu jam terakhir, hanya jika ada penggunaan pada jam sebelumnya.

Apakah ada periode maksimal antara satu emisi dan emisi berikutnya?

Tidak ada batasan seperti itu. Tampilkan penggunaan hanya saat terjadi penggunaan. Misalnya, jika Anda hanya perlu mengirimkan satu unit penggunaan per masa langganan, Anda dapat melakukannya.

Berapa lama penundaan maksimum antara waktu peristiwa terjadi dan waktu peristiwa penggunaan ditampilkan ke Microsoft?

Idealnya, peristiwa penggunaan ditampilkan setiap jam untuk peristiwa yang terjadi dalam satu jam terakhir. Namun, penundaan mungkin terjadi. Penundaan maksimum yang diizinkan adalah 24 jam, setelah itu peristiwa penggunaan tidak akan diterima. Praktik terbaiknya adalah dengan mengumpulkan penggunaan setiap jam dan dengan menampilkan penggunaan sebagai satu kejadian pada akhir jam.

Misalnya, jika peristiwa penggunaan terjadi pada pukul 13.00, Anda memiliki waktu hingga pukul 13.00 pada hari berikutnya untuk menampilkan peristiwa penggunaan yang terkait dengan peristiwa ini. Jika sistem yang menampilkan penggunaan tidak berfungsi, sistem dapat pulih, lalu mengirimkan kejadian penggunaan untuk interval jam saat penggunaan terjadi, tanpa kehilangan fidelitas.

Jika 24 jam telah berlalu setelah penggunaan aktual, Anda masih dapat menampilkan unit yang digunakan dengan peristiwa penggunaan nanti. Namun, praktik ini mungkin merusak kredibilitas laporan peristiwa penagihan untuk pelanggan akhir. Sebaiknya hindari pengiriman emisi pengukuran sekali sehari/seminggu/sebulan. Akan lebih sulit untuk memahami penggunaan aktual oleh pelanggan, dan untuk menyelesaikan masalah atau pertanyaan yang mungkin diajukan mengenai peristiwa penggunaan.

Alasan lain untuk mengirim penggunaan setiap jam adalah untuk menghindari situasi bahwa pengguna membatalkan langganan sebelum penerbit mengirim peristiwa emisi harian/mingguan/bulanan.

Apa yang terjadi ketika Anda mengirim lebih dari satu peristiwa penggunaan dalam jam yang sama?

Hanya satu peristiwa penggunaan yang diterima selama interval satu jam. Interval jam dimulai pada menit 0 dan berakhir pada menit 59. Jika lebih dari satu peristiwa penggunaan ditampilkan selama satu jam yang sama, peristiwa penggunaan berikutnya dihapus sebagai duplikat.

Apa yang terjadi ketika pelanggan membatalkan pembelian dalam waktu yang diizinkan oleh kebijakan pembatalan?

Jumlah tarif tetap tidak akan dikenakan tetapi penggunaan berlebihan akan dikenakan biaya.

Dapatkah paket pengukuran kustom digunakan untuk pembayaran satu kali?

Ya, Anda dapat menentukan dimensi kustom sebagai satu unit pembayaran satu kali dan menampilkannya hanya sekali untuk setiap pelanggan.

Dapatkah paket pengukuran kustom digunakan untuk model harga bertingkat?

Ya, hal ini dapat diterapkan dengan setiap dimensi kustom yang mewakili tingkat harga tunggal.

Misalnya, Contoso ingin mengenakan biaya $0,5 per email untuk 1000 email pertama, $0,4 per email antara 1000 dan 5000 email, dan $0,2 per email untuk di atas 5000 email. Layanan ini dapat menentukan tiga dimensi kustom, yang sesuai dengan tiga tingkat harga email. Tampilkan unit dimensi pertama selama jumlah email tetap di bawah 1000, lalu unit dimensi kedua ketika jumlah email antara 1000 dan 5000, dan akhirnya, unit dimensi ketiga untuk di atas 5000 email.

Apa yang terjadi jika layanan pengukuran Marketplace mengalami pemadaman?

Jika ISV mengirim meteran kustom dan menerima kesalahan, yang mungkin disebabkan oleh masalah di sisi Microsoft (biasanya dalam kasus kejadian serupa diterima sebelumnya tanpa kesalahan), MAKA ISV harus menunggu dan mencoba kembali emisi.

Jika kesalahan terus berlanjut, kirimkan kembali pengukur kustom tersebut pada jam berikutnya (akumulasi kuantitas). Lanjutkan proses ini hingga respons non-kesalahan diterima.

Hanya untuk penawaran SaaS

Apa yang terjadi ketika Anda menampilkan penggunaan untuk langganan SaaS yang telah dihentikan langganannya?

Setiap peristiwa penggunaan yang ditampilkan ke platform marketplace tidak akan diterima setelah langganan SaaS dihapus.

Penggunaan hanya dapat ditampilkan untuk langganan dalam status Berlangganan (dan bukan untuk langganan dalam status PendingFulfillmentStart, Suspended, atau Unsubscribed).

Satu-satunya pengecualian adalah melaporkan penggunaan untuk waktu yang sebelum langganan SaaS dibatalkan.

Misalnya, pelanggan membatalkan langganan SaaS hari ini pukul 15.00. Sekarang pukul 17.00, penerbit masih dapat menampilkan penggunaan untuk periode antara pukul 18.00 kemarin dan 15.00 hari ini untuk langganan SaaS ini.

Bisakah Anda mendapatkan daftar semua langganan SaaS, termasuk langganan aktif dan berhenti berlangganan?

Ya, saat Anda memanggil GET Subscriptions List API karena menyertakan daftar semua langganan SaaS. Bidang status dalam respons untuk setiap langganan SaaS mengambil apakah langganan aktif atau tidak berlangganan.

Apakah tanggal mulai dan selesai dari jangka waktu langganan SaaS dan emisi penggunaan yang berlebihan terhubung?

Peristiwa yang berlebihan dapat ditampilkan kapan saja untuk langganan SaaS yang ada dalam status Berlangganan. Penerbit bertanggung jawab untuk menampilkan peristiwa penggunaan berdasarkan kebijakan yang ditentukan dalam paket penagihan. Kelebihan harus dihitung berdasarkan tanggal yang ditentukan dalam jangka waktu langganan SaaS.

Misalnya, jika penerbit mendefinisikan paket SaaS yang menyertakan 1000 email seharga $100 dalam tarif tetap bulanan, setiap email di atas 1000 ditagih seharga $1 melalui dimensi kustom.

Ketika pelanggan membeli dan mengaktifkan langganan pada tanggal 6 Januari, 1000 email yang termasuk dalam tarif tetap akan dihitung mulai hari ini. Jadi, jika hingga 5 Februari (akhir bulan pertama langganan) hanya 900 email yang dikirim, pelanggan akan membayar tarif tetap hanya untuk bulan pertama langganan ini, dan tidak ada peristiwa penggunaan berlebihan yang akan ditampilkan oleh penerbit antara 6 Januari dan 5 Februari. Pada 6 Februari, langganan akan diperpanjang secara otomatis dan hitungannya akan dimulai kembali. Jika pada 15 Februari pelanggan mencapai 1000 email yang dikirim, sisa email yang dikirim hingga 5 Maret akan dikenakan biaya sebagai berlebihan ($1 per email) berdasarkan peristiwa penggunaan berlebihan yang ditampilkan oleh penerbit.