eSIM API Checklist (2026): 12 Fitur yang Harus Dimiliki eSIM API Travel — dan Cara Menguji Masing-masing

Menghubungkan API eSIM ke aplikasi, platform perjalanan, atau mesin pemesanan Anda tidaklah sulit. Yang sulit adalah mengetahui, setelah peluncuran, bahwa API melakukan penagihan ganda saat terjadi timeout, tidak dapat memberi tahu Anda saat pelanggan kehabisan data, atau tidak memberi Anda cara untuk menguji kegagalan.

Daftar periksa ini mencakup 12 fitur yang penting dalam produksi, dan untuk masing-masing fitur, cara mengujinya sebelum Anda mendaftar. Kami menggunakan TripoSIM Partner API sebagai contoh yang dikerjakan, tetapi Anda dapat menggunakan daftar periksa yang sama untuk membandingkan penyedia mana pun.

1. Autentikasi token yang aman

Apa yang harus dicari: Kredensial klien OAuth 2.0: Anda menukar ID klien dan secret dengan access token berdurasi singkat. Secret tidak pernah dikirimkan pada setiap permintaan.

Cara menguji: minta token, lalu periksa masa berlakunya. Dalam TripoSIM API, POST /auth/token mengembalikan access token yang valid selama 15 menit. Pastikan kode Anda memperbaruinya secara otomatis sebelum kedaluwarsa.

2. Kunci idempotency (tanpa penagihan ganda)

Apa yang harus dicari: header Idempotency-Key pada setiap pesanan dan top-up. Jika permintaan Anda mengalami timeout dan Anda mencoba lagi dengan kunci yang sama, API harus mengembalikan hasil asli alih-alih membuat eSIM berbayar kedua.

Cara menguji: kirim pesanan yang sama dua kali dengan kunci yang sama dan pastikan Anda hanya mendapatkan satu pesanan. Kemudian kirim kunci yang sama dengan body yang berbeda — API yang baik akan menolaknya. TripoSIM mewajibkan kunci pada pesanan produksi dan top-up, serta mengembalikan 409 IDEMPOTENCY_KEY_REUSED jika kunci digunakan kembali dengan permintaan yang berbeda.

3. Penawaran harga yang mengunci harga

Apa yang harus dicari: cara untuk mengambil harga dan menjaganya untuk waktu singkat, sehingga pelanggan Anda membayar tepat sesuai dengan apa yang Anda tunjukkan kepada mereka.

Cara menguji: buat penawaran (quote), tunggu, lalu pesan menggunakan penawaran tersebut. Penawaran TripoSIM valid selama 10 menit; penawaran yang kedaluwarsa akan mengembalikan 409 QUOTE_EXPIRED sehingga Anda dapat memberikan penawaran ulang alih-alih menagih harga yang mengejutkan.

4. Feed katalog yang bersih

Apa yang harus dicari: satu endpoint yang mencantumkan setiap paket dengan harga, data, masa berlaku, negara cakupan, 5G, dukungan top-up — dan untuk paket unlimited, batas kecepatan penuh harian.

Cara menguji: ambil katalog untuk satu negara dan bandingkan dengan situs web penyedia itu sendiri. Endpoint TripoSIM /catalog mengembalikan JSON atau CSV, mencakup paket regional yang mencakup negara tersebut, dan menambahkan field fair-use (fup_daily_mb, fup_throttle_kbps) untuk paket unlimited. Lihat [bagaimana batas harian unlimited bekerja](/blog/unlimited-esim-daily-limit-by-country-2026).

5. Pengiriman pesanan dan QR secara instan

Apa yang harus dicari: respons pesanan (atau webhook beberapa detik kemudian) harus menyertakan kode aktivasi dalam format LPA standar, misalnya LPA:1$smdp.example.com$ACTIVATION_CODE, sehingga Anda dapat menampilkan kode QR atau tautan instalasi satu ketukan.

Cara menguji: buat pesanan sandbox, buat QR dari string LPA, dan pindai dengan kamera ponsel untuk memeriksa apakah formatnya valid.

6. Webhook bertanda untuk setiap peristiwa

Apa yang harus dicari: notifikasi push untuk seluruh siklus hidup eSIM, yang ditandatangani sehingga penyerang tidak dapat memalsukannya.

TripoSIM mengirimkan delapan jenis peristiwa: order.completed, order.failed, esim.activated, esim.usage_80, esim.suspended, esim.resumed, esim.depleted dan esim.expired. Setiap permintaan membawa header X-TripoSIM-Signature — sebuah HMAC-SHA256 dari timestamp dan raw body menggunakan signing secret Anda:

<pre><code>// reject requests older than 5 minutes (replay protection) if (Math.floor(Date.now() / 1000) - parseInt(timestamp) &gt; 300) throw new Error('Webhook too old'); const expected = crypto .createHmac('sha256', signingSecret) .update(timestamp + '.' + rawBody) .digest('hex'); if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) { throw new Error('Invalid webhook signature'); }</code></pre>

Cara menguji: daftarkan webhook, picu sebuah pesanan, dan verifikasi tanda tangan di kode Anda. Kemudian ubah satu byte pada body dan pastikan pemeriksaan Anda menolaknya.

7. Sandbox yang mensimulasikan seluruh siklus hidup eSIM

Apa yang harus dicari: eSIM asli membutuhkan waktu berhari-hari untuk aktivasi dan penggunaan data. Sandbox yang baik memungkinkan Anda melakukan percepatan (fast-forward).

Cara menguji: di sandbox TripoSIM, gunakan POST /sandbox/esims/{iccid}/simulate dengan aksi activate, usage, deplete, expire atau reset. Setiap langkah akan memicu webhook yang sesuai, sehingga Anda dapat menguji email "data Anda hampir habis" dalam hitungan menit, bukan hari.

8. Simulasi kegagalan

Apa yang harus dicari: cara untuk memaksa kesalahan secara sengaja, sehingga Anda tahu aplikasi Anda dapat menanganinya.

Cara menguji: kirim header X-Sandbox-Simulate dengan mode seperti insufficient_balance, price_changed, rate_limit, provider_unavailable atau timeout, dan periksa apakah aplikasi Anda menampilkan pesan yang jelas dan hanya melakukan percobaan ulang (retry) saat seharusnya.

9. Top-up pada eSIM yang sama

Apa yang harus dicari: pelanggan yang kehabisan data harus dapat menambah lebih banyak tanpa perlu menginstal eSIM baru.

Cara menguji: panggil POST /esims/{iccid}/topup di sandbox (dengan kunci idempotency), lalu periksa saldo data baru. Periksa juga paket mana yang mendukung top-up — katalog harus memberi tahu Anda.

10. Data penggunaan dan status

Apa yang harus dicari: sebuah endpoint untuk data yang digunakan, data yang tersisa, dan masa kedaluwarsa, sehingga tim dukungan dan aplikasi Anda dapat menjawab "berapa banyak data yang tersisa?"

Cara menguji: panggil GET /esims/{iccid}/usage setelah peristiwa penggunaan yang disimulasikan. TripoSIM menyimpan cache penggunaan selama 5 menit, jadi gunakan webhook (esim.usage_80, esim.depleted) untuk peringatan waktu nyata (real-time).

11. Suspend dan resume

Apa yang harus dicari: cara untuk menjeda eSIM — misalnya saat pembayaran disengketakan atau pelanggan melaporkan ponsel hilang — dan melanjutkannya kembali nanti.

Cara menguji: suspend eSIM sandbox, konfirmasi webhook esim.suspended tiba, lalu resume dan konfirmasi esim.resumed.

12. Batas kecepatan, kode kesalahan, dan changelog yang jelas

Apa yang harus dicari: batas yang terdokumentasi, kode kesalahan yang memberi tahu Anda apakah harus mencoba lagi, dan changelog publik sehingga pembaruan tidak pernah mengejutkan Anda.

Cara menguji: baca daftar kesalahan dan petakan setiap kode ke "retry" atau "do not retry" di kode Anda. TripoSIM mengizinkan 120 permintaan per menit per akun mitra (Anda dapat mengatur batas yang lebih rendah pada API key individual), mengembalikan header Retry-After pada respons 429, menandai setiap kode kesalahan sebagai dapat diulang atau tidak, dan menerbitkan endpoint changelog.

Rencana peluncuran sederhana

1. Hari 1: dapatkan kunci sandbox, lakukan autentikasi, ambil katalog.
2. Hari 2: buat pesanan sandbox dengan kunci idempotency dan tampilkan kode QR.
3. Hari 3: tambahkan webhook, jalankan simulator siklus hidup dan kegagalan.
4. Hari 4: tambahkan top-up dan penggunaan, lalu uji pada ponsel asli dengan satu eSIM live.
5. Hari 5: meluncur secara live.

Sebagian besar tim terhubung dalam waktu kurang dari satu minggu. Baca [dokumentasi API](https://docs.triposim.com) lengkap atau lihat [panduan integrasi API eSIM](/blog/esim-reseller-api-how-to-integrate-travel-esim-sales-into-your-platform) langkah demi langkah kami.

Pertanyaan yang sering diajukan

Apa saja yang harus disertakan dalam API travel eSIM?

Minimal: autentikasi token, kunci idempotency, penawaran harga, feed katalog, kode QR/aktivasi instan, webhook bertanda, sandbox dengan simulator siklus hidup dan kegagalan, top-up, data penggunaan, suspend/resume, serta batas kecepatan dan kode kesalahan yang terdokumentasi.

Mengapa kunci idempotency penting untuk API eSIM?

Setiap pesanan eSIM membutuhkan uang sungguhan. Jika sebuah permintaan mengalami timeout dan sistem Anda mencoba lagi, kunci idempotency memastikan pengulangan tersebut mengembalikan hasil pertama alih-alih membeli eSIM kedua.

Bagaimana cara saya menguji API eSIM tanpa membeli eSIM?

Gunakan sandbox. Sandbox yang baik mensimulasikan pesanan, aktivasi, penggunaan data, penyusutan, dan kedaluwarsa — serta memungkinkan Anda memaksa kesalahan — tanpa memotong saldo dompet Anda.

Berapa lama waktu yang dibutuhkan untuk integrasi API eSIM?

Dengan API yang terdokumentasi dengan baik dan sandbox yang lengkap, sebagian besar tim dapat meluncur dalam 3–5 hari kerja.

Apakah API TripoSIM mendukung pengiriman white-label?

Ya. Anda menerima kode aktivasi dan data QR, sehingga Anda dapat mengirimkan eSIM di dalam aplikasi atau email Anda sendiri di bawah merek Anda sendiri. Lihat [program API](/api-program).

Kesimpulan

Harga memang penting, tetapi untuk API eSIM, perbedaan nyata terlihat setelah peluncuran: pengulangan yang tidak pernah menagih ganda, webhook yang dapat Anda percayai, dan sandbox yang memungkinkan Anda menguji segalanya terlebih dahulu. Jalankan daftar periksa ini pada penyedia mana pun sebelum Anda berkomitmen — dan [mulailah dengan sandbox kami](/api-program) untuk melihat bagaimana skor TripoSIM Partner API.