REST API v1
API top-up mudah alih: Hantar automatik ke telefon prabayar di 161 negara
Sambung terus ke 552 operator dan 4,330 produk dari pelayan, apl, atau platform e-dagang anda. Harga MobileTopup yang sama purata 35% di bawah nilai nominal, mulakan serta-merta dengan satu kunci.
- URL asas
- /api/v1
- Format
- JSON
- Pengesahan
- X-Api-Key
- Had kadar
- 300 seminit setiap kunci
API top-up paling berpatutan untuk perniagaan
Harga terendah yang sama seperti yang ditunjukkan
Harga API sepadan tepat. Semua produk berharga 30%+ di bawah nilai nominal tanpa bayaran penghantaran. Contoh: Philippines Globe 50 PHP (nilai $0.78), harga API $0.54 (30% di bawah nilai nominal).
Mulai serta-merta tanpa kelulusan
Daftar dan buat kunci API terus dari papan pemuka selepas top-up kredit pertama anda. Tiada kontrak atau pesanan minimum.
Liputan global sekaligus
Hantar airtime dan pakej data ke 161 negara dan 552 operator di seluruh dunia dengan proses yang sama mudah.
Tiada kebimbangan bayaran berganda
Lampirkan nombor pesanan anda pada ruangan rujukan, walaupun permintaan yang sama datang dua kali, kami hanya akan memprosesnya sekali dan mengembalikan hasil asal.
Kredit dikembalikan serta-merta jika gagal
Jika operator menolak top-up, jumlah pembayaran anda akan dipulangkan sebagai kredit dengan kod ralat yang jelas.
Rekod lengkap dengan resit
Top-up yang dihantar melalui API muncul dalam sejarah papan pemuka anda dengan resit, kod top-up, dan nombor rujukan operator.
Titik akhir
Proses: Pilih negara, operator dan produk, hantar top-up, kemudian semak status dan resit menggunakan kod top-up yang diterima.
Permulaan
- Langkah 1
Daftar
Daftar dengan hanya satu token akaun. Tiada emel atau dokumen diperlukan.
- Langkah 2
Tambah kredit
Tambah kredit melalui 12 kaedah termasuk USDT, USDC, BTC dan ETH. Top-up pertama mendapat kredit bonus berdasarkan jumlah.
- Langkah 3
Buat kunci API
Hasilkan kunci API dalam papan pemuka anda. Kunci penuh hanya ditunjukkan sekali, simpan terus ke pembolehubah persekitaran pelayan anda.
- Langkah 4
Hantar top-up
Hantar kunci melalui header X-Api-Key dan POST /v1/recharges untuk menghantar top-up.
Hantar 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 Mudah Alih
Siapa yang boleh menggunakan API?
Mana-mana ahli MobileTopup. Pendaftaran mengambil masa 1 minit dengan hanya token akaun. Selepas top-up kredit pertama anda diproses, anda boleh menjana kunci API serta-merta di papan pemuka anda, tiada permohonan atau kelulusan diperlukan.
Adakah harga API sama seperti yang ditunjukkan?
Ya, sama. Produk yang sama, harga yang sama, peraturan yang sama seperti menghantar top-up dari papan pemuka anda. Semua produk berharga 30%+ di bawah nilai nominal (purata penjimatan 35%), tanpa bayaran tambahan semasa menghantar. Pembayaran ditolak terus dari kredit akaun anda.
Bagaimana pesanan berganda dicegah?
Sertakan ID pesanan anda sebagai rujukan semasa menghantar top-up. Jika isu rangkaian menyebabkan permintaan berganda, kami akan memproses hanya yang pertama dan mengembalikan hasilnya untuk percubaan berikutnya ("duplicate": true).
Adakah had kadar?
Setiap kunci membenarkan 300 permintaan seminit. Melebihi ini akan mengembalikan HTTP 429 dengan Retry-After (saat). Jarakkan permintaan pukal dengan sewajarnya.
Apa yang berlaku jika top-up gagal?
Jika operator menolak top-up, pembayaran anda akan dipulangkan serta-merta sebagai kredit. Kod ralat dalam respons kekal konsisten untuk pengendalian automatik.
Bagaimana kunci API dilindungi?
Kunci disimpan dalam bentuk hash dan hanya dipaparkan sekali semasa penjanaan. Menjana semula kunci akan serta-merta membatalkan yang sebelumnya. Kami mengesyorkan menggunakan kunci hanya di sisi pelayan.