Integrasikan konektivitas eSIM di aplikasi Anda
Gunakan panduan ini untuk menghubungkan pembelian eSIM ke akun di aplikasi Anda. Anda memerlukan workspace Bird, integrasi API di sisi server, dan cara untuk mengautentikasi pelanggan Anda. Ikuti panduan API untuk izin dan detail permintaan.
1. Tampilkan penawaran yang dapat digunakan pelanggan Anda
Daftar penawaran untuk tujuan pelanggan dan tampilkan cakupan, kuota, masa berlaku, dan harga yang dipublikasikan dari penawaran yang dipilih. Periksa kompatibilitas perangkat dan persyaratan identifikasi sebelum pembelian.
Untuk perpanjangan otomatis, gunakan opsi checkout dari penawaran untuk menampilkan mode pembelian yang tersedia dan ketentuan yang berlaku. Simpan revisi penawaran dan harga yang dikutip bersama pilihan pelanggan. Jika kutipan harga berubah, tampilkan ketentuan baru dan minta pelanggan menyetujuinya sebelum membeli.
2. Kaitkan pembelian dengan pelanggan Anda
Simpan kunci Bird API di server Anda. Otorisasi akses ke setiap pesanan dan eSIM menggunakan akun pelanggan di aplikasi Anda; kunci API workspace dapat mengakses sumber daya milik beberapa pelanggan.
Simpan ID pelanggan Anda bersama ID pesanan dan, setelah dikirim, ID eSIM dan paket. Jika Anda memerlukan pengguna layanan bernama atau perpanjangan otomatis, buat subscriber dari kontak workspace. Penugasan mencatat siapa yang menggunakan eSIM; penugasan ini tidak membuat orang tersebut masuk ke aplikasi Anda atau memberikan akses ke kredensial.
Dompet organisasi Anda mendanai pembelian Bird. Jika Anda menagih pelanggan secara terpisah, lacak pembayaran tersebut terpisah dari pesanan eSIM agar Anda dapat menyelesaikan kegagalan pembayaran atau pengiriman.
3. Buat satu pembelian yang dapat dipulihkan
Buat dan simpan Idempotency-Key sebelum membuat pesanan. Gunakan kembali kunci tersebut dengan permintaan yang sama jika respons terputus.
Tampilkan status pemrosesan hingga pesanan mencapai hasil akhir. Simpan pesanan sebelum mengarahkan pelanggan ke instalasi, dan biarkan mereka kembali ke pesanan tersebut dari akun mereka. Untuk pesanan yang tidak didanai atau gagal, gunakan langkah pemulihan pembelian.
4. Kirimkan instruksi instalasi secara privat
Setelah pesanan selesai, buat tautan instalasi yang di-hosting untuk pelanggan yang dituju atau kirim tautan melalui email atau SMS. Ikuti panduan instalasi untuk pengiriman, kedaluwarsa, pencabutan, dan pengaturan perangkat.
Perlakukan tautan dan detail aktivasi sebagai kredensial. Jauhkan dari analitik, log publik, dan catatan dukungan rutin. Catat penyelesaian pembelian, pengiriman tautan, dan instalasi perangkat sebagai hasil yang terpisah.
Jika Anda mengganti layanan konektivitas yang sudah ada, rencanakan pembelian dan instalasi eSIM Bird yang baru. Periksa perangkat dan paket yang dituju sebelum pelanggan mengubah layanan mereka yang sudah ada. eSIM Bird API tidak mengimpor profil yang sudah ada atau mentransfer nomor ponsel.
5. Tambahkan halaman akun untuk penggunaan berkelanjutan
Biarkan pelanggan yang terautentikasi membuka kembali eSIM mereka, melihat saldo paket yang dilaporkan dan kedaluwarsa, serta menghubungi dukungan. Tampilkan stempel waktu saldo dan nilai yang tidak diketahui secara akurat.
Gunakan penawaran yang kompatibel untuk top-up dan available_actions eSIM untuk menentukan kontrol mana yang ditampilkan. Jelaskan tindakan yang dinonaktifkan menggunakan alasan yang dikembalikan, dan tangani penolakan jika ketersediaan berubah sebelum pengiriman. Ikuti panduan paket berulang untuk perpanjangan dan pembatalan.
Verifikasi gangguan dan pemulihan
Tutup browser setelah pembelian dan buka kembali akun pelanggan. Pastikan akun mengarah ke pesanan dan eSIM yang sama. Ulangi setelah instalasi dimulai.
Periksa bahwa respons pembelian yang hilang, tautan instalasi yang kedaluwarsa, dan nilai penggunaan yang tidak diketahui masing-masing mengarah ke tindakan pemulihan yang sesuai. Pastikan satu pelanggan tidak dapat membuka tautan instalasi atau eSIM pelanggan lain melalui halaman akun Anda.
Langkah berikutnya
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.