REST API v1
API top-up ponsel: Kirim otomatis ke ponsel prabayar di 161 negara
Terhubung langsung ke 552 operator dan 4,330 produk dari server, aplikasi, atau platform e-niaga Anda. Harga MobileTopup yang sama dengan rata-rata 35% di bawah nilai nominal, mulai langsung dengan satu kunci.
- URL dasar
- /api/v1
- Format
- JSON
- Autentikasi
- X-Api-Key
- Batas kecepatan
- 300 per menit per kunci
API top-up paling terjangkau untuk bisnis
Harga terendah sama seperti yang ditampilkan
Harga API persis sama. Semua produk berharga 30%+ di bawah nilai nominal tanpa biaya pengiriman. Contoh: Philippines Globe 50 PHP (nilai $0.78), harga API $0.54 (30% di bawah nilai nominal).
Mulai instan tanpa persetujuan
Daftar dan buat kunci API langsung dari dasbor setelah top-up kredit pertama. Tanpa kontrak atau pesanan minimum.
Cakupan global sekaligus
Kirim pulsa dan paket data ke 161 negara dan 552 operator di seluruh dunia dengan proses yang sama sederhana.
Tidak perlu khawatir pembayaran ganda
Lampirkan nomor pesanan Anda ke kolom referensi, bahkan jika permintaan yang sama datang dua kali, kami hanya akan memprosesnya sekali dan mengembalikan hasil aslinya.
Kredit kembali instan jika gagal
Jika operator menolak top-up, jumlah pembayaran Anda segera dikembalikan sebagai kredit dengan kode error yang jelas.
Catatan lengkap dengan tanda terima
Top-up yang dikirim melalui API muncul dalam riwayat dasbor Anda dengan tanda terima, kode top-up, dan nomor referensi operator.
Endpoint
Prosesnya: Pilih negara, operator dan produk, kirim top-up, lalu periksa status dan tanda terima menggunakan kode top-up yang diterima.
Memulai
- Langkah 1
Daftar
Daftar hanya dengan satu token akun. Tidak perlu email atau dokumen.
- Langkah 2
Tambah kredit
Tambahkan kredit melalui 12 metode termasuk USDT, USDC, BTC dan ETH. Top-up pertama kali mendapatkan bonus kredit berdasarkan jumlah.
- Langkah 3
Buat kunci API
Buat kunci API di dasbor Anda. Kunci lengkap hanya ditampilkan sekali, simpan langsung ke variabel lingkungan server Anda.
- Langkah 4
Kirim isi ulang
Kirim kunci melalui header X-Api-Key dan POST /v1/recharges untuk mengirim top-up.
Kirim top-up (cURL)
curl -X POST https://mobiletopup.io/api/v1/recharges \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"+639171234567","operator_id":"PH-GB","product_id":"ph-gb-a15c6dd","reference":"order-1042"}'Respons (201)
{ "ok": true, "data": {
"code": "RC-7KQ2-M9XD-4PWA", "status": "completed",
"phone": "+639171234567", "operator_id": "PH-GB",
"receive": "50 PHP", "price": "0.54", "currency": "USD",
"reference": "order-1042", "duplicate": false
} }FAQ API Top-Up Ponsel
Siapa yang bisa menggunakan API?
Semua anggota MobileTopup. Pendaftaran hanya membutuhkan 1 menit dengan token akun. Setelah top-up kredit pertama Anda diproses, Anda dapat langsung menghasilkan kunci API di dasbor, tanpa aplikasi atau persetujuan.
Apakah harga API sama seperti yang ditampilkan?
Ya, identik. Produk, harga, dan aturan yang sama seperti mengirim top-up dari dasbor Anda. Semua produk berharga 30%+ di bawah nilai nominal (rata-rata penghematan 35%), tanpa biaya tambahan saat mengirim. Pembayaran dipotong langsung dari kredit akun Anda.
Bagaimana pesanan duplikat dicegah?
Sertakan ID pesanan Anda sebagai referensi saat mengirim top-up. Jika masalah jaringan menyebabkan permintaan duplikat, kami hanya akan memproses yang pertama dan mengembalikan hasilnya untuk percobaan berikutnya ("duplicate": true).
Apakah ada batas tarif?
Setiap kunci mengizinkan 300 permintaan per menit. Melebihi ini akan mengembalikan HTTP 429 dengan Retry-After (detik). Atur jarak permintaan massal sesuai.
Apa yang terjadi jika top-up gagal?
Jika operator menolak top-up, pembayaran Anda akan langsung dikembalikan sebagai kredit. Kode kesalahan dalam respons tetap konsisten untuk penanganan otomatis.
Bagaimana kunci API diamankan?
Kunci disimpan dalam bentuk hash dan hanya ditampilkan sekali saat pembuatan. Membuat ulang kunci akan segera membatalkan yang sebelumnya. Kami merekomendasikan menggunakan kunci hanya di sisi server.