REST API v1
Mobile top-up API: Auto-send sa prepaid phones sa 161 bansa
Kumonekta nang direkta sa 552 operator at 4,330 produkto mula sa iyong server, app, o e-commerce platform. Parehong MobileTopup prices na average na 35% mas mababa sa face value, magsimula agad gamit ang isang key.
- Base URL
- /api/v1
- Format
- JSON
- Pagpapatunay
- X-Api-Key
- Limitasyon sa rate
- 300 bawat minuto bawat key
Ang pinaka-abot-kayang top-up API para sa mga negosyo
Parehong pinakamababang presyo tulad ng ipinapakita
Ang mga presyo ng API ay eksaktong tumutugma. Lahat ng produkto ay nagkakahalaga ng 30%+ mas mababa sa face value na walang sending fees. Halimbawa: Philippines Globe 50 PHP (halaga $0.78), presyo ng API $0.54 (30% mas mababa sa face value).
Simulan agad nang walang pag-apruba
Mag-sign up at gumawa ng iyong API key mula sa dashboard pagkatapos ng iyong unang credit top-up. Walang kontrata o minimum na order.
Global coverage kaagad
Magpadala ng airtime at data bundles sa 161 na bansa at 552 na operator sa buong mundo gamit ang parehong simpleng proseso.
Walang alalahanin sa duplicate payment
Ilakip ang iyong order number sa reference field, kahit na dumating ang parehong request nang dalawang beses, ipoprocess lang namin ito nang isang beses at ibabalik ang orihinal na resulta.
Credit back kaagad kung ito ay nabigo
Kung tanggihan ng operator ang top-up, ang iyong bayad ay agad na ibabalik bilang credit kasama ng malinaw na error codes.
Kumpletong rekord kasama ang resibo
Ang mga top-up na ipinadala sa API ay lilitaw sa iyong dashboard history kasama ang mga resibo, top-up codes, at operator reference numbers.
Mga Endpoint
Ang proseso: Pumili ng bansa, operator at produkto, magpadala ng top-up, pagkatapos suriin ang status at resibo gamit ang natanggap na top-up code.
Simula
- Hakbang 1
Mag-sign up
Magrehistro gamit lamang ang isang account token. Walang email o dokumento na kinakailangan.
- Hakbang 2
Magdagdag ng credit
Magdagdag ng credit sa pamamagitan ng 12 paraan kasama ang USDT, USDC, BTC at ETH. Ang unang top-up ay makakatanggap ng bonus credit batay sa halaga.
- Hakbang 3
Gumawa ng API key
Gumawa ng mga API key sa iyong dashboard. Ang buong key ay ipapakita lamang nang isang beses, i-save ito nang direkta sa iyong server environment variables.
- Hakbang 4
Magpadala ng top-up
Ipadala ang mga key sa pamamagitan ng X-Api-Key header at POST /v1/recharges para magpadala ng top-ups.
Magpadala ng 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"}'Tugon (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
} }Mobile Top-Up API FAQ
Sino ang maaaring gumamit ng API?
Kahit sinong miyembro ng MobileTopup. Ang pag-signup ay tumatagal ng 1 minuto gamit lamang ang account token. Pagkatapos ma-proseso ang iyong unang credit top-up, maaari kang bumuo ng mga API key agad sa iyong dashboard, walang application o approval na kailangan.
Pareho ba ang mga presyo ng API sa ipinapakita?
Oo, pareho. Parehong produkto, parehong presyo, parehong mga patakaran tulad ng pagpapadala ng top-ups mula sa iyong dashboard. Lahat ng produkto ay nagkakahalaga ng 30%+ mas mababa sa face value (average na 35% savings), walang dagdag na bayad kapag nagpapadala. Ang mga bayad ay direktang ibabawas mula sa iyong account credit.
Paano napipigilan ang mga duplicate order?
Isama ang iyong order ID bilang reference kapag nagpapadala ng top-ups. Kung ang network issues ay nagdulot ng duplicate requests, ipoprocess lamang namin ang una at ibabalik ang resulta nito para sa mga susubok na attempt ("duplicate": true).
May mga limitasyon ba sa rate?
Ang bawat key ay nagpapahintulot ng 300 requests kada minuto. Ang paglampas dito ay magbabalik ng HTTP 429 kasama ang Retry-After (segundo). I-space out ang mga bulk requests nang naaayon.
Ano ang mangyayari kung nabigo ang isang top-up?
Kung tinanggihan ng operator ang top-up, ang iyong bayad ay agad na ibabalik bilang credit. Ang mga error code sa response ay mananatiling pare-pareho para sa automated handling.
Paano nase-secure ang mga API key?
Ang mga key ay naka-hash at ipinapakita lamang minsan sa pag-generate. Ang pag-regenerate ng mga key ay agad na nag-i-invalidate sa mga naunang key. Inirerekomenda naming gamitin ang mga key sa server-side lamang.