Periksa penggunaan dan tambahkan top-up
Gunakan panduan ini untuk menambahkan data ke eSIM yang sudah ada. Anda memerlukan izin untuk membaca eSIM dan membeli paket, serta dana wallet yang cukup. Ketersediaan top-up bergantung pada profil, paket yang ada, dan penawaran yang dipilih.
1. Periksa paket yang aktif
Buka profil dari eSIMs dan tinjau Data packages. Dengan API, daftar paket eSIM dan periksa status, kedaluwarsa, dan saldonya.
balance.total_bytes adalah kuota yang dibeli. used_bytes, remaining_bytes, atau used_percent bernilai null berarti tidak ada pengukuran yang tersedia. Perlakukan nilai-nilai tersebut sebagai tidak diketahui di aplikasi Anda.
Baca field balance_reporting pada eSIM untuk menentukan apa yang ditampilkan. Jika nilainya unavailable, tampilkan kuota yang dibeli tanpa menyajikannya sebagai sisa data terukur. Jika nilainya available, konsumsi masih bisa tidak diketahui sampai laporan tiba. Riwayat penggunaan harian terpisah dan saat ini tidak tersedia.
Gunakan balance.as_of untuk waktu pembaruan saldo terakhir; sebelum konsumsi dilaporkan, nilainya bisa berupa waktu pengiriman paket. balance.observed_at adalah waktu pengukuran jaringan jika tersedia. Tampilkan timestamp bersama penggunaan terukur agar pelanggan dapat mengenali laporan yang tertunda.
2. Daftar penawaran yang kompatibel
Pilih Top up pada eSIM, atau panggil Daftar penawaran yang kompatibel untuk profil tersebut. Gunakan penawaran yang dikembalikan, bukan memilih dari katalog umum. Cakupan di negara yang sama tidak menjamin kompatibilitas.
Jika top-up tidak tersedia, baca available_actions pada eSIM untuk mengetahui alasannya. Pesanan yang belum selesai atau batas paket dapat mencegah pembelian berikutnya. Selesaikan pesanan yang ada sebelum mencoba lagi. Perbarui penawaran yang kompatibel sebelum mengirim: penawaran dapat menjadi tidak tersedia antara waktu pemilihan dan pembelian.
eSIM dalam status expired bersifat dorman dan dapat kembali ke active setelah top-up yang kompatibel selesai. Periksa tindakan yang tersedia dan penawaran yang kompatibel sebelum memutuskan bahwa profil yang terpasang perlu diganti.
3. Tinjau ketentuan yang berlaku
Tampilkan kuota, cakupan, harga dan mata uang yang dipublikasikan, serta masa berlaku dari penawaran yang dipilih. Bandingkan masa berlaku paket baru dengan batas layanan active_until pada eSIM jika ada. Jika batas tersebut memotong masa berlaku yang dibeli, pesanan mengembalikan 409 dengan masa berlaku efektif. Tampilkan periode yang lebih pendek dan dapatkan persetujuan sebelum mengatur acknowledge_shortened_validity: true.
Top-up membuat paket baru. Top-up tidak mengubah saldo paket yang sudah ada atau memperpanjang kedaluwarsa paket tersebut. Periksa aktivasi dan kedaluwarsa paket baru setelah pengiriman.
4. Setujui dan pantau pesanan
Konfirmasi pembelian di dashboard. Dengan API, buat pesanan menggunakan esim_id yang ada, offer_id yang dipilih, revision dari penawaran sebagai offer_revision, dan pricing.price sebagai expected_price. Abaikan subscriber_id; top-up mempertahankan penetapan yang ada. Simpan ID pesanan dan Idempotency-Key untuk percobaan ulang.
Jika harga atau revisi yang diterima berubah, ambil penawaran terkini dan konfirmasi ketentuan baru sebelum mengirim pembelian lain. Salin jumlah harga dan mata uang yang dikembalikan tanpa konversi atau pembulatan.
Pantau pesanan di Orders, atau dapatkan pesanan melalui API. Periksa status setelah respons 201 dan 202. Jika respons hilang, coba lagi permintaan yang sama dengan kunci yang sama; jangan membuat pembelian pengganti selama hasilnya belum pasti.
5. Periksa paket yang dihasilkan
Ketika pesanan berstatus completed, gunakan package_id untuk mendapatkan paket baru. Pastikan eSIM tujuan, cakupan, dan kuota sesuai dengan pembelian. Top-up menggunakan profil yang terpasang; Anda tidak perlu menginstal eSIM baru. Paket yang menunggu penggunaan pertama bisa belum memiliki timestamp aktivasi atau kedaluwarsa.
Pemecahan masalah
Jika pesanan selesai tetapi saldo masih belum diketahui, bandingkan status paket dan stempel waktu laporan. Pelaporan bisa tertunda dari penggunaan perangkat; memesan lagi tidak menyelesaikan penundaan tersebut. Jika pembelian gagal, periksa detail kegagalan dan referensi kredit sebelum mencoba lagi.
Langkah berikutnya
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.