eSIMfly MCP

API de eSIM para Desarrolladores: Vende eSIMs en Tu Propio Producto

Integra planes de datos eSIM al por mayor para 200 países en tu aplicación, plataforma o tienda a través de una sola API REST: catálogo, pedidos, recargas, uso y gestión completa del ciclo de vida.

Quiénes Crean con la API de eSIM

Las empresas utilizan la integración de eSIM al por mayor para añadir ingresos por conectividad a su producto existente.

Aplicaciones de Viajes y OTAs

Ofrece una venta adicional de eSIM en el momento de la reserva. Tus viajeros llegan conectados y tú te quedas con el margen de cada plan vendido.

Revendedores y MVNOs

Obtén eSIMs a tarifas al por mayor y véndelas a través de tus propios canales, con tus propios precios y empaquetado.

Plataformas de IoT y Flotas

Aprovisiona y supervisa la conectividad de dispositivos y vehículos a través de fronteras desde una sola integración.

Superapps y Fintech

Añade planes de datos internacionales como una función nativa junto a pagos, banca o productos de fidelización.

CAPACIDADES DE LA API

Todo lo que Necesitas para Gestionar eSIMs Programáticamente

La API cubre todo el recorrido, desde explorar paquetes al por mayor hasta gestionar eSIMs activas en el campo.

Catálogo y Precios

Explora cada paquete de datos disponible con precios al por mayor para 200 países y consulta el saldo de tu cuenta antes de realizar un pedido.

Obtener Todos los PaquetesConsulta de Saldo

Pedidos y Recargas

Aprovisiona nuevas eSIMs al instante y recarga las existentes. Los pedidos devuelven códigos QR y detalles de activación listos para entregar a tus usuarios.

Crear PedidoRecargar Paquetes y Pedidos

Ciclo de Vida de la eSIM

Gestiona cada eSIM que hayas emitido: consulta el estado y el uso de datos, suspende o cancela líneas, revisa eventos de red y envía SMS.

Listar / Consultar eSIMsEstado de la eSIMCancelar / Suspender / ActivarInforme de UsoEventos de RedEnviar SMS

Webhooks

Registra endpoints para recibir notificaciones en tiempo real sobre pedidos y eventos del ciclo de vida de la eSIM, sin necesidad de sondeos.

Gestión de WebhooksNotificaciones de Eventos

Tarifas de eSIM al Por Mayor, Tu Margen

Los socios de la API compran paquetes de datos a precios al por mayor y establecen sus propios precios minoristas. El catálogo abarca planes locales, regionales y globales en 200 países y más de 450 redes, de modo que una sola integración cubre todos los destinos a los que viajan tus usuarios. La facturación basada en saldo simplifica la liquidación: recarga tu cuenta y cada pedido se descuenta de ella a tu tarifa al por mayor.

Si prefieres una tienda completa en lugar de crear la tuya propia, nuestra plataforma de revendedor eSIM de marca blanca incluye un sitio web con marca, panel de control y aplicaciones móviles sobre la misma infraestructura.

Seguro por Diseño: Solicitudes Firmadas con HMAC

Cada llamada a la API se autentica con una firma HMAC-SHA256 sobre la marca de tiempo de la solicitud, un ID de solicitud único, tu código de acceso y el cuerpo de la solicitud, lo que proporciona verificación de integridad y protección contra ataques de repetición. En la documentación encontrarás ejemplos de firma listos para usar en Node.js, Python y PHP.

POST /api/v1/business/orders HTTP/1.1
Host: esimfly.net
Content-Type: application/json
RT-AccessCode: your-access-code
RT-RequestID: 6f1c2e4a-...        # unique UUID v4
RT-Timestamp: 1752403200000       # ms since epoch
RT-Signature: A3F0...             # HMAC-SHA256, see docs

{ "package_code": "...", "quantity": 1 }

Obtén Acceso a la API en Tres Pasos

1. Crea una cuenta empresarial

Regístrate para obtener una cuenta empresarial de eSIMfly y cuéntanos tu caso de uso y el volumen esperado.

2. Genera tus claves de API

Crea y gestiona las credenciales de acceso desde el panel empresarial y luego recarga tu saldo.

3. Integra y lanza

Sigue la documentación para explorar paquetes, realizar un pedido de prueba y, opcionalmente, registrar un webhook para eSIMs aprovisionadas de forma asíncrona.

PREGUNTAS FRECUENTES

Preguntas sobre la API de eSIM, Respondidas

¿Qué es la API de eSIM de eSIMfly?+

La API de eSIMfly es una API REST que te permite comprar, aprovisionar y gestionar eSIMs programáticamente a tarifas al por mayor. Puedes explorar el catálogo de paquetes, crear pedidos, recargar planes, supervisar el uso y gestionar todo el ciclo de vida de la eSIM (activar, suspender, cancelar) desde tu propia aplicación, con cobertura en 200 países y más de 450 redes.

¿Para quién es la API de eSIM?+

La API está diseñada para empresas que quieren integrar la conectividad eSIM en su propio producto: aplicaciones de viajes y plataformas de reservas, revendedores de telecomunicaciones y MVNOs, plataformas de IoT y flotas, y cualquier servicio que quiera ofrecer datos internacionales a sus usuarios sin establecer relaciones con operadores.

¿Cómo funciona la autenticación en la API?+

Las solicitudes se autentican con firmas HMAC-SHA256. Cada solicitud incluye un código de acceso, un ID de solicitud único, una marca de tiempo y una firma calculada con tu clave secreta, lo que proporciona verificación de integridad de la solicitud y evita ataques de repetición. En la documentación hay ejemplos de código para Node.js, Python y PHP.

¿Cómo obtengo acceso a la API de eSIM?+

Crea una cuenta empresarial de eSIMfly y luego genera claves de API desde el panel empresarial. Los niveles de precios al por mayor dependen del volumen: contacta con nuestro equipo de ventas para hablar de tarifas según el volumen de pedidos esperado.

¿La API admite webhooks?+

Sí. Los webhooks te notifican cuando las eSIMs aprovisionadas de forma asíncrona están listas: algunos operadores (como KDDI Japan) tardan unos minutos y, en lugar de sondear, recibes un POST firmado con los detalles de la eSIM. La mayoría de los proveedores aprovisionan de forma síncrona en la respuesta del pedido, y el estado y el uso se consultan mediante los endpoints de estado y uso.

¿Cuáles son los límites de velocidad de la API?+

La API permite 1.000 solicitudes por hora por cuenta. Las solicitudes con más de 5 minutos de antigüedad se rechazan como parte de la protección contra ataques de repetición. Si necesitas límites más altos para tu integración, contacta con ventas.

SDK OFICIAL · NODE.JS / TYPESCRIPT

Omite el código de firma: instala el SDK

npm install @esimfly/sdk te ofrece acceso tipado a toda la API: firma HMAC, IDs de solicitud actualizados, pedidos idempotentes, sincronización de catálogo con ritmo controlado y verificación de firmas de webhooks integrados. Cero dependencias, Node.js 18+, con licencia MIT y código abierto. Los SDK de PHP y Python son los siguientes.

¿Usas un agente de IA? Añade el servidor MCP alojado https://mcp.esimfly.net/mcp a Claude, ChatGPT o Cursor e inicia sesión con tu cuenta empresarial, sin necesidad de pegar claves. Busca planes, consulta el uso y diagnostica eSIMs contra la API en vivo; solo lectura por defecto, con un paso de confirmación antes de cualquier pedido. ¿Prefieres local? npx -y @esimfly/mcp.

Tutoriales de Integración

Código Node.js funcional, desde la primera solicitud hasta webhooks de producción.

[

EMPIEZA AQUÍ · GUÍA DE ARQUITECTURA

Guía de Integración de la API de eSIM

Los cuatro componentes básicos, autenticación firmada, aprovisionamiento síncrono vs. webhooks, una lista de verificación para evaluar proveedores y los errores que solo aparecen en producción.

Lee la guía](https://esimfly.net/esim-api/integration-guide)

[

PARTE 1 · ~30 MIN

Vende eSIMs en Tu Aplicación con Node.js

Autenticación HMAC, catálogo de paquetes, creación de pedidos y entrega de códigos QR: una tienda funcional completa.

Comienza el tutorial](https://esimfly.net/esim-api/tutorials/sell-esims-nodejs)[

PARTE 2 · CICLO DE VIDA

Recargas, Seguimiento de Uso y Webhooks

Consultas de uso en vivo, ventas de recargas en eSIMs existentes y webhooks firmados sin sondeos.

Continúa con la parte dos](https://esimfly.net/esim-api/tutorials/topups-usage-webhooks)

¿Listo para integrar eSIMs en tu producto?

Empieza con la documentación o habla con nuestro equipo sobre tarifas al por mayor para tu volumen.