Mengelola paket eSIM berlangganan

Gunakan langganan berulang untuk membeli paket data sesuai jadwal penagihan. Anda memerlukan izin untuk membeli layanan eSIM, dana wallet organisasi, dan subscriber untuk orang yang menggunakan eSIM. Ketersediaan bergantung pada penawaran dan profil yang dipilih.

Panduan ini mencakup pembelian baru dan pendaftaran pada eSIM yang sudah ada. API eSIM tidak menyediakan operasi untuk mengalihkan langganan aktif ke paket lain.

1. Tinjau ketentuan berlangganan

Untuk eSIM baru, dapatkan opsi checkout. Tawarkan perpanjangan otomatis saat recurrence.available bernilai true dan gunakan quote untuk ketentuan yang diterima. Jika tidak tersedia, periksa unavailable_reason dan tawarkan opsi pembelian yang didukung.

Untuk eSIM yang sudah ada, daftar penawaran yang kompatibel dengan recurring_only=true, lalu dapatkan ketentuan berulang dari penawaran yang dipilih. Pendaftaran memeriksa kompatibilitas kembali sebelum menerima pembelian.

Tampilkan harga berulang, mata uang yang dipublikasikan, kadens, dan mode pengiriman sebelum penerimaan. Harga yang ditampilkan belum termasuk pajak; riwayat periode mencatat total yang dikenakan dan pajaknya. calendar_month mengikuti bulan kalender; fixed_days menggunakan jumlah hari 24 jam yang dinyatakan. Wallet organisasi membayar layanan; subscriber tidak memiliki wallet terpisah.

Periksa apakah paket mencakup interval yang dibayar (exact_period) atau setiap perpanjangan membeli paket standar (recurring_top_up). Dengan top-up berulang, aktivasi dan kedaluwarsa mengikuti ketentuan paket dan dapat berbeda dari batas penagihan. Jangan menjanjikan data tanpa gangguan hanya karena perpanjangan dijadwalkan.

2. Tetapkan pelanggan

Di dashboard, buka profil dari eSIMs, buka More eSIM actions, pilih Assign person, pilih kontak, dan konfirmasi Assign person. Anda tidak dapat mengubah orang yang ditetapkan setelahnya.

Dengan API, buat subscriber menggunakan contact_id dari kontak di workspace Anda. Ini memerlukan email_marketing:read untuk Contacts dan esim:write. Respons mengembalikan subscriber yang sudah ada jika kontak tersebut sudah memilikinya.

Membuat asosiasi ini mencegah penghapusan kontak, termasuk setelah eSIM berakhir. Asosiasi subscriber saat ini tidak dapat dihapus, dilepas, atau dianonimkan. Tentukan apakah penyimpanan data tersebut sesuai dengan proses pelanggan Anda sebelum membuatnya.

Untuk profil yang sudah ada, tetapkan eSIM menggunakan subscriber_id. Mengulangi penetapan yang sama mengembalikan rekaman yang sudah ada; menetapkan orang yang berbeda mengembalikan 409. Untuk profil baru, sertakan subscriber_id dalam pembelian agar penetapan selesai bersamaan dengan pengiriman.

Penetapan tidak memberikan akses workspace atau izin untuk membaca kredensial instalasi. Tangani pengumpulan identifikasi secara terpisah menggunakan persyaratan penawaran dan panduan integrasi.

3. Daftarkan dan verifikasi pengiriman

Untuk eSIM yang sudah ditetapkan di dashboard, buka Automatic renewal dan pilih Set up renewal. Pilih Package, pilih Check recurring price, lalu tinjau harga, kadens, dan ketentuan pengiriman paket. Pilih Buy first package and renew untuk membeli periode pertama dan mengaktifkan perpanjangan otomatis.

Untuk eSIM baru melalui API, buat order dengan offer_id yang dipilih, subscriber_id workspace, dan ketentuan checkout yang diterima berikut:

• Atur offer_revision ke recurrence.quote.offer_revision.
• Atur recurrence.recurrence_revision ke recurrence.quote.recurrence_revision.
• Atur recurrence.accepted_price ke objek recurrence.quote.price yang lengkap.

Kirim Idempotency-Key; jangan sertakan esim_id dan expected_price untuk pembelian ini. Simpan order ID beserta recurring_subscription_id-nya. Periode penagihan pertama dimulai saat pembayaran didanai. Pantau order hingga selesai atau gagal, gunakan langkah pemulihan pembelian jika diperlukan.

Untuk eSIM yang sudah ditetapkan, buat langganan berulang dengan esim_id, offer_id, revision dari penawaran sebagai offer_revision, dan revision dari ketentuan berulang sebagai recurrence_revision. Kirim price lengkap dari ketentuan berulang sebagai accepted_price. Idempotency-Key wajib disertakan; gunakan kembali dengan permintaan yang sama untuk memulihkan pendaftaran. Pendaftaran langsung membeli periode pertama; tidak menunggu paket yang ada habis.

Dapatkan langganan dan lihat daftar periodenya. Konfirmasi pembayaran dan pengiriman paket secara terpisah. Untuk eSIM baru, kirimkan detail instalasi setelah order-nya selesai.

4. Pantau perpanjangan

Buka Subscriptions untuk memeriksa ketentuan yang diterima, status, dan perpanjangan berikutnya. Di API, baca next_renewal_at, stop_reason, dan riwayat periode. Perubahan harga yang dipublikasikan memerlukan penerimaan ulang; perpanjangan yang tidak didanai menghentikan pembelian selanjutnya.

Jika status bernilai needs_attention, periksa periode terbaru dan order terkait. Pengiriman yang belum terselesaikan dapat tetap berstatus harus dibayar dan memblokir pendaftaran pengganti. Hubungi dukungan dengan referensi tersebut sebelum membeli pengganti.

5. Hentikan perpanjangan selanjutnya

Di bagian Automatic renewal pada eSIM, pilih Cancel renewal. Tinjau akhir periode berbayar saat ini, lalu konfirmasi Cancel renewal di dialog. Periksa langganan yang diperbarui untuk melihat tanggal pembatalannya.

Dengan API, batalkan langganan, lalu baca kembali. Periksa cancel_at_period_end, cancellation_effective_at, dan next_renewal_at untuk mengonfirmasi kapan perpanjangan berakhir. Periode yang sudah terikat tetap harus dibayar. Paket yang sudah dikirimkan mempertahankan masa berlakunya sendiri, dan profil yang terinstal tetap tersimpan.

Menghapus profil dari ponsel tidak membatalkan perpanjangan. Melepas eSIM akan menonaktifkannya secara permanen, menghanguskan sisa data, dan tidak memberikan pengembalian dana. Gunakan tindakan layanan jika Anda ingin mengubah konektivitas sekaligus perpanjangan.

Pemecahan masalah

Menambahkan dana ke wallet tidak secara otomatis memulai ulang langganan yang berhenti. Periksa stop_reason dan status akhir layanan sebelumnya sebelum menerima pendaftaran baru. Pengiriman berbayar yang gagal dan kreditnya memiliki hasil yang terpisah: periksa order_status dan refund_transaction_id di riwayat periode.

Verifikasi perjalanan pelanggan

Pastikan pelanggan dapat menemukan kuota yang dibeli, kedaluwarsa paket, perpanjangan berikutnya, tanggal pembatalan, dan kontak dukungan. Verifikasi pengiriman paket pertama dan uji data seluler pada perangkat yang kompatibel. Periksa pembayaran dan pengiriman periode berikutnya secara terpisah dari tanggal perpanjangan terjadwalnya.

Langkah berikutnya

• Lihat saldo dan beli top-up sekali bayar.
• Siapkan instalasi perangkat.
• Selidiki masalah pembayaran atau pengiriman.