Integrasi API
TersediaIntegrasi API
Berencana menjual eSIM di dalam aplikasi atau alur pemesanan Anda sendiri? Beri tahu kami kebutuhan Anda.
API tersedia bagi mitra yang disetujui setelah tim penjualan mengaktifkan akses. Buat kunci hanya baca atau kunci pemesanan di Dasbor Mitra. Semua pembelian menggunakan dompet prabayar USD Anda.
Panduan cepat API
Setelah akun disetujui, tim penjualan menetapkan harga dan mengaktifkan akses API. Buat kunci di Dasbor Mitra. Kunci hanya baca tidak dapat membuat pesanan. Pembelian juga harus diaktifkan pada akun Anda.
https://simvoro.com/api/partner/v1Gunakan kunci bearer di sisi server pada setiap permintaan. Jangan masukkan kunci ke kode peramban atau URL. Kunci dapat dicabut di Dasbor Mitra.
Authorization: Bearer YOUR_API_KEY| Metode | Endpoint | Hasil |
|---|---|---|
| GET | /products?destination=japan | Harga USD dan ID produk yang ditetapkan untuk Anda. Filter berdasarkan slug tujuan; gunakan cursor untuk paginasi. |
| GET | /balance | Saldo dompet, dana yang ditahan, dan USD yang tersedia. |
| GET | /transactions | Transaksi dompet dan nextCursor. |
| GET | /orders | Ringkasan pesanan mitra dan nextCursor (50 per halaman). |
| POST | /orders | Tahan dana dan pesan satu eSIM. Memerlukan kunci dengan izin pemesanan. |
| GET | /orders/{orderId} | Status pesanan, penggunaan data pada sinkronisasi terakhir, dan informasi pemasangan setelah pengiriman. |
Buat pesanan
Kirim UUID sebagai Idempotency-Key. Gunakan kembali UUID yang sama setelah batas waktu habis atau koneksi gagal. Kirim harga yang dikonfirmasi pelanggan dan pastikan perangkat penerima mendukung eSIM serta tidak terkunci operator. Perubahan harga langsung menghasilkan 409 PRICE_CHANGED. Ini adalah API produksi; pembelian yang diterima menggunakan dana dompet sungguhan.
POST /api/partner/v1/orders
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: 83c77d9f-395f-4ff0-8ed6-c461bda46559
{"productId":"PRODUCT_ID_FROM_CATALOG","expectedPrice":"2.25","deviceConfirmed":true}Respons 201 berisi orderId dan esim; periksa esim.status dan esim.failure. Periksa pesanan setiap 10 detik. Dana ditahan terlebih dahulu dan dibebankan setelah pengiriman terverifikasi. Pengulangan dapat mengembalikan pesanan yang gagal. Jika hasil pemasok belum pasti, dana tetap ditahan selama pesanan asli direkonsiliasi. Informasi pemasangan bersifat pribadi dan hanya muncul setelah pengiriman terverifikasi.
Jumlah adalah string desimal dalam USD. Daftar mengembalikan items dan nextCursor; lanjutkan hingga nextCursor bernilai null. Batas: 120 permintaan per kunci per menit dan 10 percobaan pembelian per pengguna per menit. Patuhi Retry-After pada 429. Kesalahan umum: 401 kunci tidak valid, 403 izin ditolak, 402 dana tidak cukup, 404 pesanan tidak dapat diakses, 409 konflik harga atau idempotensi, 503 layanan tidak tersedia. Periksa pesanan asli sebelum mencoba pembelian lain.
Yang perlu dicantumkan dalam permintaan Anda
- Platform Anda dan siapa pelanggan Anda
- Perkiraan volume bulanan Anda
- Destinasi yang ingin Anda tawarkan
- Apa yang perlu dilakukan sistem Anda, misalnya memesan eSIM dan menampilkan kode QR eSIM tersebut kepada pelanggan Anda
Jadi mitra
Kirim pengajuan dan tim kami akan menghubungi Anda terkait pengajuan tersebut.