Integración de API eSIM: guía para aprovisionar eSIM

2 jul 2026·8 min de lectura·Por eSIM Tech
Editor de código con una petición y una respuesta de la API de aprovisionamiento de eSIM

Integrar una API eSIM es una de las funciones con más retorno que puede lanzar un producto de viajes o de telecomunicaciones: con unos pocos endpoints, tu checkout se convierte en una tienda de conectividad. Esta guía recorre la integración completa desde el punto de vista del desarrollador: aprovisionamiento, entrega, webhooks y los casos límite que conviene cubrir.

El flujo básico

Toda integración de revendedor de eSIM se reduce a tres pasos:

1. Customer pays          →  your checkout
2. Provision the eSIM     →  POST /v1/esims
3. Deliver the QR code    →  confirmation page + email

Aprovisionamiento

Cuando el pago se completa, tu backend hace una sola llamada:

curl -X POST https://api.esim.tech/v1/esims \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "product": "local-nl-unlimited",
    "reference": "order_8412"
  }'

La respuesta llega al momento con todo lo que necesitas:

{
  "id": "esim_L4nX...",
  "iccid": "8931089...",
  "lpa": "LPA:1$smdp.esim.tech$K9MX-....",
  "phone_number": "+31612345678",
  "status": "ready",
  "created_at": "2026-07-02T09:41:12Z"
}

El código LPA viene en la propia respuesta, así que no hay que hacer polling ni esperar un correo o una tarea asíncrona. Con unos 120 ms de principio a fin, puedes llamarla de forma síncrona dentro del checkout. En los productos de eSIM locales, el número de teléfono llega en la misma respuesta, de modo que puedes enseñarle al cliente su nuevo número local antes incluso de que escanee el código QR.

Entrega

Convierte la cadena LPA en un código QR (con cualquier librería de QR; la cadena es el contenido del código) y:

  • Muéstralo en la página de confirmación
  • Envíalo por correo como respaldo (muchos clientes instalan más tarde, con wifi)
  • En móvil, ofrece también la instalación por enlace universal, para que quien compra desde el mismo dispositivo no necesite una segunda pantalla para escanear

Webhooks del ciclo de vida

Registra un endpoint de webhook y recibirás eventos como estos:

{ "type": "esim.activated",   "esim": "esim_L4nX", "at": "..." }
{ "type": "usage.threshold",  "esim": "esim_L4nX", "used_mb": 4096, "threshold": 0.8 }
{ "type": "balance.low",      "esim": "esim_L4nX", "remaining_mb": 512 }

Usa el evento balance.low para lanzar un correo de recarga en un clic, que le llega al cliente justo cuando más lo necesita. Los revendedores que lo automatizan suelen ver entre un 20 y un 30 % más de ingresos por cliente.

Decisiones de diseño que conviene acertar

Idempotencia. Pasa tu ID de pedido como reference y reintenta sin riesgo si falla la red. Así nunca aprovisionas (ni pagas) dos eSIM para un mismo pedido.

Aprovisiona al cobrar, nunca antes. Las eSIM se facturan al aprovisionarlas. No las generes por adelantado para carritos abandonados.

Guarda el ICCID. Es el identificador estable que usarás para soporte, recargas y consultas de consumo.

Resuelve pronto la pregunta “¿mi teléfono es compatible?”. Comprueba la compatibilidad del dispositivo con eSIM en tu interfaz antes del checkout, y no después en un correo de reembolso.

Tipos de producto que puedes aprovisionar

Una sola integración te da acceso a todo el catálogo:

  • Pago por uso: facturación por MB, recargas por API, más de 190 países
  • eSIM locales: número de teléfono local real + voz + SMS + datos (ilimitados) en más de 25 países
  • SIM de datos UE: hasta 500 GB para routers, autocaravanas y flotas en toda la UE
  • Respaldo 5G: conectividad de conmutación para ubicaciones fijas

Todos comparten la misma estructura de API. Solo cambia el identificador product, así que ampliar tu oferta más adelante es un cambio de configuración y no un proyecto nuevo. Si primero quieres evaluar el negocio, empieza por cómo ser revendedor de eSIM.

Salir a producción

  1. Crea tu cuenta en resellers.esim.tech
  2. Integra el aprovisionamiento y la generación del QR contra el sandbox
  3. Conecta el endpoint de webhooks (como mínimo, activación y saldo bajo)
  4. Prueba el flujo de instalación completo en un iPhone y en un Android reales
  5. Cambia a las claves de producción y lanza

La autenticación usa un token Bearer estándar, la API es REST/JSON sin más y no hay volúmenes mínimos, así que tu primera eSIM aprovisionada puede ir ya a un cliente real.

Preguntas frecuentes

¿Qué es un código LPA?

El código LPA (Local Profile Assistant) es la cadena de activación que usa un dispositivo compatible con eSIM para descargar su perfil SIM. Normalmente se muestra como código QR. Formato: LPA:1$smdp.example.com$ACTIVATION-CODE. Si tu API lo devuelve al instante, puedes mostrar el código QR directamente en el checkout.

¿Cuánto tarda el aprovisionamiento de una eSIM por API?

En eSIM.tech, una llamada POST /v1/esims devuelve el código LPA y el ICCID en unos 120 milisegundos de principio a fin, lo bastante rápido para aprovisionar de forma síncrona durante el checkout.

¿Necesito conocimientos de telecomunicaciones para integrar una API eSIM?

No. Si sabes integrar una API de pagos, sabes integrar una API eSIM. La parte compleja de telecomunicaciones (servidores SM-DP+, acuerdos con operadores, generación de perfiles) queda oculta tras la interfaz REST.

¿Cómo instalan la eSIM los clientes?

Escanean el código QR que muestras (o tocan un enlace universal en el mismo dispositivo). Después, iOS y Android descargan e instalan el perfil. Una guía de instalación clara para cada plataforma reduce bastante las consultas al soporte.