Kelola siklus hidup langganan SaaS

Pasar komersial mengelola seluruh siklus hidup langganan SaaS setelah dibeli oleh pengguna akhir. Ini menggunakan halaman arahan, API Pemenuhan, API Operasi, dan webhook sebagai mekanisme untuk mendorong aktivasi, penggunaan, pembaruan, dan pembatalan langganan SaaS yang sebenarnya. Tagihan pengguna akhir didasarkan pada status langganan SaaS yang disimpan Microsoft.

Negara Bagian langganan SaaS

Diagram berikut menunjukkan keadaan langganan SaaS dan tindakan yang berlaku.

Dibeli namun belum diaktifkan(PendingFulfillmentStart)

Setelah pengguna akhir atau penyedia solusi cloud (CSP) membeli penawaran SaaS di marketplace komersial, penerbit diberitahu mengenai pembelian tersebut. Penerbit kemudian dapat membuat dan mengkonfigurasi akun SaaS baru yang dilakukan penerbit untuk pengguna akhir.

Agar pembuatan akun terjadi:

1. Pelanggan memilih tombol Konfigurasi akun sekarang yang tersedia untuk penawaran SaaS setelah pembelian berhasil dilakukan di Microsoft AppSource atau portal Microsoft Azure. Atau, pelanggan dapat menggunakan tombol Konfigurasikan sekarang di email yang akan mereka terima segera setelah pembelian.
2. Microsoft kemudian memberi tahu mitra tentang pembelian dengan membuka URL halaman arahan dengan parameter token (token identifikasi pembelian dari pasar komersial) di tab browser baru.

Contoh panggilan tersebut adalah https://contoso.com/signup?token=<blob>, sedangkan URL halaman arahan untuk penawaran SaaS ini di Pusat Mitra dikonfigurasi sebagaihttps://contoso.com/signup. Token ini memberi penerbit ID yang secara unik mengidentifikasi pembelian SaaS dan pelanggan.

Tip

Jangan sertakan karakter tanda pagar (#) di URL halaman arahan. Jika tidak, pelanggan tidak akan dapat mengakses halaman arahan Anda.

Penting

URL halaman arahan harus siap dan berjalan sepanjang hari, setiap hari, dan siap menerima panggilan baru dari Microsoft setiap saat. Jika halaman arahan tidak tersedia, pelanggan tidak akan dapat mendaftar untuk layanan SaaS dan mulai menggunakannya.

Selanjutnya, penerbit harus meneruskan token kembali ke Microsoft dengan memanggil SaaS Resolve API, dan memasukkan token sebagai nilai x-ms-marketplace-token header parameter. Sebagai hasil dari panggilan Resolve API, token ditukar dengan rincian pembelian SaaS seperti ID unik pembelian, ID penawaran yang dibeli, dan ID paket yang dibeli.

Pada halaman arahan, pelanggan harus masuk ke akun SaaS baru atau yang sudah ada melalui akses menyeluruh (SSO) Microsoft Entra.

Catatan

Penerbit tidak akan diberi tahu tentang pembelian SaaS sampai pelanggan memulai proses konfigurasi dari sisi Microsoft.

Penerbit harus menerapkan SSO untuk memberikan pengalaman pengguna yang diperlukan oleh Microsoft untuk alur ini. Pastikan untuk menggunakan aplikasi Microsoft Entra multipenyewa dan mengizinkan akun kantor dan sekolah atau akun Microsoft pribadi saat mengonfigurasi SSO. Persyaratan ini hanya berlaku untuk halaman arahan, bagi pengguna yang diarahkan ke layanan SaaS ketika telah masuk dengan informasi masuk Microsoft. SSO tidak diperlukan untuk semua rincian masuk ke layanan SaaS.

Catatan

Jika SSO mengharuskan administrator memberikan izin ke aplikasi, deskripsi penawaran di Pusat Mitra harus mengungkapkan bahwa akses tingkat admin diperlukan. Pengungkapan ini untuk mematuhi kebijakan sertifikasi pasar komersial.

Setelah masuk, pelanggan harus menyelesaikan konfigurasi SaaS di sisi penerbit. Selanjutnya penerbit harus memanggil Aktifkan API Langganan untuk mengirim sinyal ke Azure Marketplace bahwa penyediaan akun SaaS selesai. Tindakan ini memulai siklus penagihan pelanggan. Jika panggilan Aktifkan API Langganan tidak berhasil, pelanggan tidak ditagih untuk pembelian.

Pembeli dan pemilik akun penagihan menerima email yang meminta mereka untuk mengonfigurasi akun.

Catatan

Publisher memiliki waktu 30 hari untuk menyelesaikan aset ketika status tertundaPendingFulfillmentStart, jika tidak, aset akan dibatalkan karena siklus penagihan tidak dimulai dan masing-masing pembelian tidak ditagih, status akan berubah menjadi Tidak Berlangganan. Pelanggan tidak akan ditagih untuk pembelian.

Aktif(Berlangganan)

Aktif (Berlangganan) adalah kondisi stabil dari langganan SaaS yang disediakan. Setelah Microsoft memproses panggilanAktifkan API Langganan,langganan SaaS ditandai sebagaiBerlangganan. Pelanggan sekarang dapat menggunakan layanan SaaS di sisi penerbit dan ditagih.

Saat langganan SaaS telah aktif, pelanggan dapat memilih Kelola pengalaman SaaS dari portal Microsoft Azure atau Pusat Admin Microsoft 365. Tindakan ini juga menyebabkan Microsoft memanggil URL halaman arahan denganparameter token, seperti yang terjadi pada alur Aktifkan. Penerbit harus membedakan antara pembelian baru dan manajemen akun SaaS yang ada, dan menangani panggilan URL halaman arahan ini.

Email pemberitahuan aktivasi dikirim ke pembeli dan pemilik akun penagihan.

Sedang diperbarui(Berlangganan)

Tindakan ini berarti bahwa pembaruan untuk langganan SaaS aktif yang ada sedang diproses oleh Microsoft dan penerbit. Pembaruan semacam itu dapat dimulai dengan:

• Pelanggan dari pasar komersial.
• CSP dari pasar komersial.
• Pelanggan dari situs SaaS penerbit (namun tidak untuk pembelian yang dilakukan CSP).

Dua jenis pembaruan tersedia untuk langganan SaaS:

• Perbarui paket saat pelanggan memilih paket lain untuk berlangganan.
• Perbarui kuantitas saat pelanggan mengubah jumlah lisensi yang dibeli untuk langganan.

Hanya langganan aktif yang dapat diperbarui. Saat langganan sedang diperbarui, statusnya tetap Aktif di sisi Microsoft.

Pembaruan dimulai dari pasar komersial

Dalam alur ini, pelanggan mengubah paket langganan atau kuantitas lisensi dari pusat portal Azure atau Admin Microsoft 365.

1. Setelah pembaruan dimasukkan, Microsoft akan memanggil URL webhook penerbit, dikonfigurasi di bidang Webhook Koneksi di halaman Konfigurasi Teknis di Pusat Mitra, dengan nilai yang sesuai untuk tindakan dan parameter relevan lainnya.
2. Pihak penerbit harus membuat perubahan yang diperlukan pada layanan SaaS, dan memberi tahu Microsoft saat selesai dengan memanggil Status Pembaruan API Operasi.
3. Jika patch dikirim dengan status gagal, proses pembaruan tidak akan selesai di sisi Microsoft. Langganan SaaS menyimpan paket dan kuantitas lisensi yang ada.

Catatan

Penerbit harus memanggil PATCH untuk memperbarui Status Operation API dengan respons Kegagalan/ Keberhasilan dalam jendela waktu10 detik setelah menerima pemberitahuan webhook. Jika PATCH status operasi tidak diterima dalam 10 detik, rencana perubahan secara otomatis di-patch sebagai Berhasil.

Urutan panggilan API untuk skenario pembaruan yang dimulai dari pasar komersial ditampilkan dalam diagram berikut.

Pembaruan dimulai dari penerbit

Dalam alur ini, pelanggan mengubah paket langganan atau kuantitas lisensi yang dibeli dari layanan SaaS itu sendiri.

1. Sebelum membuat perubahan yang diminta di sisi penerbit, kode penerbit harus memanggil Rencana Perubahan API atau Kualitas Perubahan API atau keduanya.

2. Microsoft akan menerapkan perubahan pada langganan, lalu memberi tahu penerbit melalui Webhook koneksi untuk menerapkan perubahan yang sama.

3. Hanya dengan begitu penerbit harus membuat perubahan yang diperlukan ke langganan SaaS, dan memberi tahu Microsoft ketika perubahan dilakukan dengan memanggilStatus Pembaruan API Operasi.

Urutan panggilan API untuk skenario pembaruan yang dimulai dari pihak penerbit ditampilkan dalam diagram berikut.

Email pemberitahuan yang menunjukkan perubahan paket akan dikirim ke pembeli dan pemilik akun penagihan.

Email pemberitahuan yang menunjukkan perubahan jumlah akan dikirim ke pembeli dan pemilik akun penagihan.

Ditangguhkan(Ditangguhkan)

Kondisi ini menunjukkan bahwa pembayaran pelanggan untuk layanan SaaS tidak diterima. Microsoft akan memberi tahu penerbit tentang perubahan ini dalam status langganan SaaS. Pemberitahuan dilakukan melalui panggilan ke webhook dengan parametertindakan diaturkeDitangguhkan.

Penerbit mungkin atau tidak mungkin membuat perubahan pada layanan SaaS yang dilakukan penerbit. Kami menyarankan agar penerbit menyediakan informasi ini bagi pelanggan yang ditangguhkan dan membatasi atau memblokir akses pelanggan ke layanan SaaS. Ada kemungkinan pembayaran tidak akan pernah diterima.

Catatan

Microsoft memberi pelanggan masa tenggang 30 hari sebelum membatalkan langganan secara otomatis. Setelah masa tenggang 30 hari berakhir webhook akan menerima tindakan Unsubscribe.

Saat langganan dalam statusDitangguhkan:

• Mitra atau ISV harus menyimpan akun SaaS dalam keadaan yang dapat dipulihkan, sehingga fungsionalitas penuh dapat dipulihkan tanpa kehilangan data atau pengaturan apa pun.
• Mitra atau ISV harus mengharapkan permintaan untuk mengembalikan langganan, jika pembayaran diterima selama masa tenggang, atau permintaan untuk membatalkan penyediaan langganan pada akhir masa tenggang. Kedua permintaan akan dikirim melalui mekanisme webhook.

Status langganan diubah menjadi Ditangguhkan yang dilakukan Microsoft sebelum penerbit mengambil tindakan apa pun. Hanya langganan Aktif yang dapat ditangguhkan.

Email pemberitahuan yang menunjukkan perubahan status menjadi 'ditangguhkan' akan dikirim ke pembeli dan pemilik akun penagihan.

Setelah periode penangguhan 30 hari, email mengenai pembatalan pasca-penangguhan akan dikirim ke pembeli dan pemilik akun penagihan.

Dipulihkan(Ditangguhkan)

Tindakan ini menunjukkan bahwa instrumen pembayaran pelanggan telah berlaku lagi, pembayaran telah dilakukan untuk langganan SaaS, dan langganan sedang dipulihkan. Dalam hal ini:

1. Microsoft memanggil webhook denganparameter tindakan yang diatur kePulihkan nilai.
2. Penerbit memastikan bahwa langganan kembali beroperasi penuh di sisi penerbit.
3. Proses Pulihkan berhasil dan pelanggan ditagih kembali untuk langganan SaaS.

Hanya langganan yang ditangguhkan yang dapat dipulihkan. Langganan SaaS yang ditangguhkan tetapdalam keadaan ditangguhkan saat sedang dipulihkan. Setelah operasi ini selesai, status langganan akan menjadi Aktif.

Email akan dikirim ke pembeli dan pemilik penagihan setelah transisi dari status ditangguhkan ke status dipulihkan.

Diperbarui(Berlangganan)

Langganan SaaS secara otomatis diperbarui oleh Microsoft pada akhir masa langganan sebulan atau setahun. Default untuk pengaturan perpanjangan otomatis berlakuuntuksemua langganan SaaS. Langganan Active SaaS akan terus diperbarui dengan irama biasa. Microsoft menyediakan pemberitahuan webhook beritahukan saja untuk memperbarui peristiwa. Pelanggan dapat menonaktifkan perpanjangan otomatis untuk langganan SaaS melalui Portal Admin Microsoft 365. Dalam hal ini, langganan SaaS akan secara otomatis dibatalkan pada akhir masa penagihan saat ini. Pelanggan juga dapat membatalkan langganan SaaS kapan saja.

Hanya langganan aktif yang diperbarui secara otomatis. Langganan tetap aktif selama proses perpanjangan, dan jika perpanjangan otomatis berhasil. Setelah perpanjangan, tanggal mulai dan berakhir dari masa langganan diperbarui ke tanggal masa langganan baru.

Jika perpanjangan otomatis gagal karena ada masalah pembayaran, langganan akanditangguhkandan penerbit akan diberi tahu.

Email pengingat untuk perpanjangan akan dikirim ke pembeli dan pemilik akun penagihan, 30 hari sebelum tanggal perpanjangan tahunan/multiyear.

Dibatalkan(Berhenti berlangganan)

Langganan mencapai status ini sebagai tanggapan terhadap tindakan eksplisit pelanggan atau CSP dengan pembatalan langganan dari situs penerbit, portal Azure, atau Pusat Admin Microsoft 365. Langganan juga dapat dibatalkan secara implisit, sebagai akibat dari tidak membayar iuran, setelah berada dalam statusDitangguhkanselama 30 hari.

Setelah penerbit menerima panggilan webhook pembatalan, mereka harus menyimpan data pelanggan untuk pemulihan berdasarkan permintaan setidaknya selama tujuh hari. Hanya dengan begitu data pelanggan dapat dihapus.

Langganan SaaS dapat dibatalkan kapan saja dalam siklus hidupnya. Setelah langganan dibatalkan, langganan tidak dapat diaktifkan kembali.

Email pembatalan akan dikirim ke pembeli dan pemilik akun penagihan.

Langkah berikutnya

• API Berlangganan pemenuhan SaaS v2
• API operasi pemenuhan SaaS v2

Tutorial video

• Membangun Portal Penerbit SaaS Sederhana di .NET
• Menggunakan API Pemenuhan REST Penawaran SaaS