Bagikan melalui

Mengelola siklus hidup langganan SaaS

  • Artikel

Marketplace komersial mengelola seluruh siklus hidup langganan SaaS setelah pembeliannya 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 dipertahankan Microsoft.

Status langganan SaaS

Diagram berikut menunjukkan status langganan SaaS dan tindakan yang berlaku.

Diagram memperlihatkan siklus hidup perangkat lunak sebagai langganan layanan di marketplace.

Dibeli tetapi belum diaktifkan (PendingFulfillmentStart)

Setelah pengguna akhir atau penyedia solusi cloud (CSP) membeli penawaran SaaS di pasar komersial, penerbit diberi tahu tentang pembelian. Penerbit kemudian dapat membuat dan mengonfigurasi akun SaaS baru di sisi penerbit untuk pengguna akhir.

Agar pembuatan akun terjadi:

  1. Pelanggan memilih tombol Konfigurasi akun sekarang yang tersedia untuk penawaran SaaS setelah pembelian berhasil 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 marketplace komersial) di tab browser baru.

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

Ujung

Jangan sertakan karakter tanda pound (#) di URL halaman arahan. Jika tidak, pelanggan tidak dapat mengakses halaman arahan Anda. Penerbit memiliki waktu 30 hari untuk menyelesaikan aset saat status PendingFulfillmentStart. Jika tidak, aset dibatalkan. Karena siklus penagihan tidak dimulai dan pembelian masing-masing tidak ditagih, status kemudian berubah menjadi Berhenti berlangganan. Pelanggan tidak ditagih untuk pembelian.

Penting

URL halaman arahan harus aktif dan berjalan sepanjang hari, setiap hari, dan siap untuk menerima panggilan baru dari Microsoft selalu. Jika halaman arahan menjadi tidak tersedia, pelanggan tidak 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 parameter x-ms-marketplace-token header. Sebagai hasil dari panggilan Resolve API, token ditukar dengan detail 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.

Nota

Penerbit tidak 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, untuk pengguna yang dialihkan ke layanan SaaS ketika sudah masuk dengan kredensial Microsoft. SSO tidak diperlukan untuk semua rincian masuk ke layanan SaaS.

Nota

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

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

Diagram memperlihatkan panggilan A P I untuk skenario provisi.

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

Nota

Publisher memiliki waktu 30 hari untuk menyelesaikan aset saat status PendingFulfillmentStart. Jika tidak, aset dibatalkan karena siklus penagihan tidak dimulai dan pembelian masing-masing tidak ditagih. Status berubah menjadi Berhenti berlangganan. Pelanggan tidak ditagih untuk pembelian.

Aktif (Berlangganan)

Aktif (Berlangganan) adalah status stabil dari langganan SaaS yang disediakan. Setelah proses sisi Microsoft, Aktifkan langganan API panggilan, langganan SaaS ditandai sebagai Berlangganan. Pelanggan sekarang dapat menggunakan layanan SaaS di sisi penerbit dan ditagih.

Saat langganan SaaS sudah aktif, pelanggan dapat memilih Mengelola pengalaman SaaS dari portal Microsoft Azure atau Pusat Admin Microsoft 365. Tindakan ini juga menyebabkan Microsoft memanggil URL halaman arahan dengan parameter token, seperti yang terjadi dalam 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 ke langganan SaaS aktif yang ada sedang diproses oleh Microsoft dan penerbit. Pembaruan dimulai oleh:

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

Dua jenis pembaruan tersedia untuk langganan SaaS:

  • Perbarui paket saat pelanggan memilih paket lain untuk langganan.
  • 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 marketplace komersial

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

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

Nota

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

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

Diagram memperlihatkan panggilan A P I untuk pembaruan yang dimulai marketplace.

Pembaruan dimulai dari penerbit

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

  1. Sebelum perubahan yang diminta dilakukan di sisi penerbit, kode penerbit harus memanggil Change Plan API atau Change Quantity API atau keduanya.
  2. Microsoft menerapkan perubahan pada langganan, lalu memberi tahu penerbit melalui webhook Koneksi untuk menerapkan perubahan yang sama.
  3. Hanya dengan demikian, penerbit harus membuat perubahan yang diperlukan pada langganan SaaS, dan memberi tahu Microsoft ketika perubahan dilakukan dengan memanggil Status Pembaruan Api Operasi.

Urutan panggilan API untuk skenario pembaruan yang dimulai dari sisi penerbit diperlihatkan dalam diagram berikut.

Diagram memperlihatkan panggilan A P I untuk pembaruan yang dimulai oleh sisi penerbit.

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

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

Ditangguhkan (Ditangguhkan)

Status ini menunjukkan bahwa pembayaran pelanggan untuk layanan SaaS tidak diterima. Microsoft memberi tahu penerbit tentang perubahan ini dalam status langganan SaaS. Pemberitahuan dilakukan melalui panggilan ke webhook dengan parameter tindakan diatur ke Ditangguhkan.

Penerbit mungkin atau mungkin tidak membuat perubahan pada layanan SaaS di sisi penerbit. Sebaiknya penerbit menyediakan informasi ini untuk pelanggan yang ditangguhkan dan membatasi atau memblokir akses pelanggan ke layanan SaaS. Ada kemungkinan bahwa pembayaran tidak pernah diterima.

Nota

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

Saat langganan berada dalam status Ditangguhkan:

  • Mitra atau ISV harus menyimpan akun SaaS dalam keadaan dapat dipulihkan, sehingga fungsionalitas penuh dapat dipulihkan tanpa kehilangan data atau pengaturan.
  • Mitra atau ISV harus mengharapkan permintaan untuk mengembalikan langganan, jika pembayaran diterima selama masa tenggang, atau permintaan untuk membatalkan provisi langganan di akhir masa tenggang. Mekanisme webhook mengirimkan kedua permintaan.

Status langganan diubah menjadi Ditangguhkan di sisi Microsoft sebelum penerbit mengambil tindakan apa pun. Hanya Langganan aktif yang dapat ditangguhkan.

Email pemberitahuan yang menunjukkan perubahan status menjadi Ditangguhkan dikirim ke pembeli dan pemilik akun penagihan.

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

Dipulihkan (Ditangguhkan)

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

  1. Microsoft memanggil webhook dengan parameter tindakan diatur ke nilai Dipulangkan.
  2. Penerbit memastikan bahwa langganan beroperasi penuh lagi di sisi penerbit.
  3. Proses Pemulihan berhasil dan pelanggan ditagih lagi untuk langganan SaaS.

Hanya langganan yang ditangguhkan yang dapat dipulihkan. Langganan SaaS yang ditangguhkan tetap dalam status ditangguhkan saat sedang dipulihkan. Setelah operasi ini selesai, status langganan menjadi Active.

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

Diperpanjang (Berlangganan)

Microsoft secara otomatis memperbarui langganan SaaS di akhir masa langganan sebulan atau setahun. Default untuk pengaturan autorenewal true untuk semua langganan SaaS. Langganan SaaS aktif terus diperbarui dengan irama reguler. Microsoft menyediakan pemberitahuan webhook khusus informasi untuk memperpanjang peristiwa. Pelanggan dapat menonaktifkan perpanjangan otomatis untuk langganan SaaS melalui Portal Admin Microsoft 365. Dalam hal ini, langganan SaaS secara otomatis dibatalkan pada akhir jangka waktu penagihan saat ini. Pelanggan juga dapat membatalkan langganan SaaS kapan saja.

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

Jika autorenewal gagal karena masalah dengan pembayaran, langganan menjadi Ditangguhkan dan penerbit diberi tahu.

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

Dibatalkan (Berhenti berlangganan)

Langganan mencapai status ini setelah tindakan pelanggan atau CSP eksplisit terjadi untuk membatalkan langganan. Mereka membatalkan langganan dari situs penerbit, portal Microsoft Azure, atau Pusat Admin Microsoft 365. Langganan juga dibatalkan secara implisit, sebagai akibat dari tidak dibayarnya iuran dan setelah berada dalam status Ditangguhkan selama 30 hari.

Setelah penerbit menerima panggilan webhook pembatalan, mereka harus menyimpan data pelanggan untuk pemulihan atas 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 dikirim ke pembeli dan pemilik akun penagihan.

Konten terkait

tutorial Video