REST API v1
API de recargas móviles: Envío automático a teléfonos prepagos en 161 países
Conéctate directamente a 552 operadores y 4,330 productos desde tu servidor, aplicación o plataforma de comercio electrónico. Los mismos precios de MobileTopup, con un promedio de 35% por debajo del valor nominal, comienza al instante con una clave.
- URL base
- /api/v1
- Formato
- JSON
- Autenticación
- X-Api-Key
- Límites de tasa
- 300 por minuto por clave
La API de recargas más económica para empresas
Los mismos precios más bajos que se muestran
Los precios de la API coinciden exactamente. Todos los productos cuestan 30%+ por debajo del valor nominal sin tarifas de envío. Ejemplo: Philippines Globe 50 PHP (valor $0.78), precio API $0.54 (30% por debajo del valor nominal).
Comienza al instante sin aprobación
Regístrate y crea tu clave API directamente desde tu panel después de tu primera recarga de crédito. Sin contratos ni pedidos mínimos.
Cobertura global de inmediato
Envía saldo y paquetes de datos a 161 países y 552 operadores en todo el mundo con el mismo proceso sencillo.
Sin preocupaciones por pagos duplicados
Adjunta tu número de pedido al campo de referencia, incluso si la misma solicitud llega dos veces, solo la procesaremos una vez y devolveremos el resultado original.
Crédito devuelto al instante si falla
Si el operador rechaza la recarga, el monto de tu pago se reembolsa inmediatamente como crédito con códigos de error claros.
Registros completos con recibos
Las recargas enviadas por API aparecen en el historial de tu panel con recibos, códigos de recarga y números de referencia del operador.
Endpoints
El proceso: Selecciona país, operador y producto, envía la recarga y luego verifica el estado y los recibos usando el código de recarga recibido.
Comenzando
- Paso 1
Registrarse
Regístrate con solo un token de cuenta. No se requiere correo electrónico ni documentos.
- Paso 2
Agregar crédito
Agrega crédito mediante 12 métodos, incluidos USDT, USDC, BTC y ETH. Las primeras recargas obtienen crédito adicional según el monto.
- Paso 3
Crear clave API
Genera claves API en tu panel. Las claves completas solo se muestran una vez, guárdalas directamente en las variables de entorno de tu servidor.
- Paso 4
Enviar recarga
Envía claves mediante el encabezado X-Api-Key y POST /v1/recharges para enviar recargas.
Enviar recarga (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"}'Respuesta (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
} }Preguntas frecuentes sobre la API de Recarga Móvil
¿Quién puede usar la API?
Cualquier miembro de MobileTopup. El registro toma 1 minuto con solo un token de cuenta. Después de que se procese tu primera recarga de crédito, puedes generar claves de API inmediatamente en tu panel, sin necesidad de solicitud o aprobación.
¿Los precios de la API son los mismos que se muestran?
Sí, idénticos. Los mismos productos, los mismos precios, las mismas reglas que al enviar recargas desde tu panel. Todos los productos cuestan 30%+ por debajo del valor nominal (promedio de 35% de ahorro), sin tarifas adicionales al enviar. Los pagos se deducen directamente de tu crédito.
¿Cómo se previenen los pedidos duplicados?
Incluye tu ID de pedido como referencia al enviar recargas. Si problemas de red causan solicitudes duplicadas, procesaremos solo la primera y devolveremos su resultado para intentos posteriores ("duplicate": true).
¿Hay límites de tasa?
Cada clave permite 300 solicitudes por minuto. Exceder esto devuelve HTTP 429 con Retry-After (segundos). Espacia las solicitudes masivas en consecuencia.
¿Qué pasa si falla una recarga?
Si el operador rechaza la recarga, tu pago se reembolsa instantáneamente como crédito. Los códigos de error en la respuesta permanecen consistentes para un manejo automatizado.
¿Cómo se aseguran las claves de API?
Las claves se almacenan cifradas y solo se muestran una vez al generarse. Regenerar claves invalida inmediatamente las anteriores. Recomendamos usar claves solo en el lado del servidor.