REST API v1
API ricarica mobile: Invia automaticamente ai telefoni prepagati in 161 paesi
Connettiti direttamente a 552 operatori e 4,330 prodotti dal tuo server, app o piattaforma e-commerce. Stessi prezzi MobileTopup mediamente inferiori del 35% rispetto al valore nominale, inizia immediatamente con una chiave.
- URL base
- /api/v1
- Formato
- JSON
- Autenticazione
- X-Api-Key
- Limiti di frequenza
- 300 al minuto per chiave
L'API ricarica più conveniente per le aziende
Stessi prezzi più bassi mostrati
I prezzi API corrispondono esattamente. Tutti i prodotti costano 30%+ in meno rispetto al valore nominale senza commissioni di invio. Esempio: Filippine Globe 50 PHP (valore $0.78), prezzo API $0.54 (30% sotto il valore nominale).
Inizia subito senza approvazione
Registrati e crea la tua chiave API direttamente dal dashboard dopo il primo ricarica di credito. Nessun contratto o ordine minimo.
Copertura globale immediata
Invia ricariche e pacchetti dati a 161 paesi e 552 operatori in tutto il mondo con lo stesso semplice processo.
Nessuna preoccupazione di pagamenti duplicati
Allega il numero del tuo ordine al campo di riferimento, anche se la stessa richiesta arriva due volte, la elaboreremo solo una volta e restituiremo il risultato originale.
Rimborso immediato del credito in caso di fallimento
Se l'operatore rifiuta la ricarica, l'importo del pagamento viene immediatamente rimborsato come credito con codici di errore chiari.
Registri completi con ricevute
Le ricariche inviate via API appaiono nella cronologia del dashboard con ricevute, codici di ricarica e numeri di riferimento dell'operatore.
Endpoint
Il processo: Seleziona paese, operatore e prodotto, invia la ricarica, quindi controlla lo stato e le ricevute utilizzando il codice di ricarica ricevuto.
Per iniziare
- Passo 1
Registrati
Registrati con un solo token di account. Nessuna email o documento richiesto.
- Passo 2
Aggiungi credito
Aggiungi credito tramite 12 metodi inclusi USDT, USDC, BTC e ETH. Le prime ricariche ricevono credito bonus in base all'importo.
- Passo 3
Crea chiave API
Genera chiavi API nel tuo dashboard. Le chiavi complete vengono mostrate solo una volta, salvarle direttamente nelle variabili d'ambiente del tuo server.
- Passo 4
Invia ricarica
Invia le chiavi tramite l'header X-Api-Key e POST /v1/recharges per inviare ricariche.
Invia ricarica (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"}'Risposta (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 Ricarica Mobile
Chi può usare l'API?
Qualsiasi membro di MobileTopup. La registrazione richiede 1 minuto con solo un token dell'account. Dopo che il primo accredito di credito è stato elaborato, puoi generare chiavi API immediatamente nel tuo dashboard, senza bisogno di applicazione o approvazione.
I prezzi API sono gli stessi mostrati?
Sì, identici. Stessi prodotti, stessi prezzi, stesse regole dell'invio di ricariche dal tuo dashboard. Tutti i prodotti costano 30%+ in meno rispetto al valore nominale (risparmio medio del 35%), senza commissioni aggiuntive durante l'invio. I pagamenti vengono detratti direttamente dal credito del tuo account.
Come vengono prevenuti gli ordini duplicati?
Includi il tuo ID ordine come riferimento quando invii ricariche. Se problemi di rete causano richieste duplicate, elaboreremo solo la prima e restituiremo il suo risultato per i tentativi successivi ("duplicate": true).
Ci sono limiti di richiesta?
Ogni chiave consente 300 richieste al minuto. Superare questo limite restituisce HTTP 429 con Retry-After (secondi). Distribuisci di conseguenza le richieste in blocco.
Cosa succede se una ricarica fallisce?
Se l'operatore rifiuta la ricarica, il pagamento viene rimborsato istantaneamente come credito. I codici di errore nella risposta rimangono coerenti per la gestione automatizzata.
Come vengono protette le chiavi API?
Le chiavi vengono memorizzate hash e vengono visualizzate solo una volta alla generazione. Rigenerare le chiavi invalida immediatamente quelle precedenti. Consigliamo di usare le chiavi solo lato server.