eSimfly Logo
API DE ESIM Y MAYORISTA

API de eSIM para desarrolladores: vende eSIM en tu propio producto

Integra planes de datos eSIM mayoristas para 200 países en tu app, plataforma o tienda con una sola API REST: catálogo, pedidos, recargas, consumo y gestión completa del ciclo de vida.

Quién construye con la API de eSIM

Las empresas usan la integración eSIM mayorista para añadir ingresos por conectividad a su producto actual.

Apps de viaje y OTA

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

Revendedores y OMV

Compra eSIM a precios mayoristas y véndelas por tus propios canales, con tus precios y tu empaquetado.

Plataformas IoT y de flotas

Aprovisiona y supervisa la conectividad de dispositivos y vehículos entre fronteras desde una sola integración.

Superapps y fintech

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

CAPACIDADES DE LA API

Todo lo que necesitas para gestionar eSIM de forma programática

La API cubre todo el recorrido: desde consultar los paquetes mayoristas hasta gestionar las eSIM activas sobre el terreno.

Catálogo y precios

Consulta todos los paquetes de datos disponibles con precios mayoristas para 200 países y comprueba el saldo de tu cuenta antes de pedir.

Get All PackagesBalance Query

Pedidos y recargas

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

Create OrderTopup Packages & Orders

Ciclo de vida de la eSIM

Gestiona todas las eSIM que has emitido: consulta el estado y el consumo de datos, suspende o cancela líneas, revisa eventos de red y envía SMS.

List / Query eSIMseSIM StatusCancel / Suspend / ActivateUsage ReportNetwork EventsSend SMS

Webhooks

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

Webhook ManagementEvent Notifications

Precios mayoristas de eSIM, tu margen

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

Si prefieres una tienda completa en lugar de construir la tuya, nuestra plataforma eSIM de marca blanca incluye un sitio web, un panel y apps móviles con tu marca sobre la misma infraestructura.

Seguridad por diseño: peticiones firmadas con HMAC

Cada llamada a la API se autentica con una firma HMAC-SHA256 calculada sobre la marca de tiempo de la petición, un identificador de petición único, tu código de acceso y el cuerpo de la petición, lo que garantiza la integridad y protege contra ataques de repetición. En la documentación encontrarás ejemplos de firma listos para 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 }

Consigue acceso a la API en tres pasos

1. Crea una cuenta de empresa

Regístrate con una cuenta de empresa en eSIMfly y cuéntanos tu caso de uso y el volumen previsto.

2. Genera tus claves de API

Crea y gestiona tus credenciales de acceso desde el panel de empresa y recarga tu saldo.

3. Integra y lanza

Sigue la documentación para consultar los paquetes, hacer un pedido de prueba y, si lo necesitas, registrar un webhook para las eSIM aprovisionadas de forma asíncrona.

PREGUNTAS FRECUENTES

Respuestas sobre la API de eSIM

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

La API de eSIMfly es una API REST que te permite comprar, aprovisionar y gestionar eSIM de forma programática a precios mayoristas. Puedes consultar el catálogo de paquetes, crear pedidos, recargar planes, supervisar el consumo 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á pensada para empresas que quieren integrar conectividad eSIM en su propio producto: apps de viaje y plataformas de reservas, revendedores de telecomunicaciones y OMV, plataformas de IoT y flotas, y cualquier servicio que quiera ofrecer datos internacionales a sus usuarios sin tener que negociar con operadores.

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

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

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

Crea una cuenta de empresa en eSIMfly y genera tus claves de API desde el panel de empresa. Los niveles de precios mayoristas dependen del volumen: contacta con nuestro equipo comercial para conocer las tarifas según el volumen de pedidos previsto.

¿La API admite webhooks?+

Sí. Los webhooks te avisan cuando una eSIM aprovisionada de forma asíncrona está lista: algunos operadores (como KDDI en Japón) tardan unos minutos y, en lugar de consultar repetidamente, recibes un POST firmado con los datos de la eSIM. La mayoría de los proveedores aprovisionan de forma síncrona en la respuesta del pedido, y el estado y el consumo se consultan mediante los endpoints correspondientes.

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

La API permite 1000 peticiones por hora y cuenta. Las peticiones 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.

¿Listo para integrar eSIM en tu producto?

Empieza por la documentación o habla con nuestro equipo sobre precios mayoristas para tu volumen.