eSIM Prepaid Platform

Connectivity Global necesitaba dejar de gestionar por hoja de cálculo la venta de eSIM a sus distribuidores. El encargo: un dashboard donde cada cliente comprara sus líneas, y una API para los que quisieran integrarse.

La condición de partida marcaba toda la arquitectura: la activación de las líneas y el envío del QR al usuario ocurren en sincronía con la plataforma. Lo que había que construir no era un activador de eSIM. Era el sistema que decide quién puede comprar, cuánto le cuesta y qué pasa con su dinero.

Vender conectividad en decenas de países sin tocar la red

El reto

• Activación y renovación viven en sistemas externos. Había que diseñar la frontera: estados de pedido (Pending, Activated…), identificador propio por pedido y una respuesta de API honesta sobre qué ha pasado, recuperar el QR y notificar al cliente el estado tanto dentro del CRM como por email.

• El saldo es la autorización. Sin crédito suficiente no hay compra. Eso convierte al wallet en el punto crítico del sistema: si se descuenta dos veces o se descuenta sin que la línea llegue a existir, el problema es contable, no técnico.

• Aislamiento entre clientes. Cada usuario ve sus pedidos y solo los suyos, sobre una base de datos común. Una fuga aquí es una fuga de la cartera de clientes de un competidor.

• Dos superficies, una lógica. Dashboard y API tenían que hacer exactamente lo mismo, con las mismas reglas de crédito. Duplicar la lógica en dos capas es la vía rápida a que diverjan.

• Reporting sin castigar la app. El cliente necesitaba sus pedidos volcados a Google Sheets, un servicio con cuotas de llamadas y latencia impredecible.

La solución

- Wallet prepago como puerta de entrada

Cada cliente tiene un saldo asignado por administración. Toda compra lo comprueba primero y lo descuenta después; sin fondos, la operación no llega a existir.

El saldo no es un número editable: es un libro de movimientos. Cada carga y cada descarga queda registrada y consultable desde User → Wallet Top-Up, accesible solo para administradores. Un balance sin historial es una cifra que nadie puede defender en una discusión con un cliente.

- Tienda B2B multipaís

El catálogo se navega por lo que de verdad decide la compra: país o región, datos locales, datos en roaming, cobertura efectiva del roaming (EU27 + UK, etc.), operador y precio.

La compra se resuelve en un paso: confirmación con el resumen del plan y el email del usuario final, que es a donde viajará el QR desde el sistema y que se muestra en la ficha de cada una de las líneas.

- Renovaciones por número

Las renovaciones se buscan por número de teléfono —el único identificador que el revendedor tiene a mano cuando le llama su cliente— y muestran el plan vigente antes de confirmar.

- API con documentación dentro del producto

Cinco endpoints, sin adornos: autenticación con bearer token, consulta de planes, activación, consulta de fondos y detalle de pedido para conocer su estado.

La documentación no vive en un PDF que envejece: está dentro del dashboard, detrás del login, junto a la plataforma que describe.

- Administración

Alta y gestión de países y planes, perfiles de cliente con sus precios asociados, y soporte por incidencia vinculada a la línea afectada, que es como se describe un problema en teleco: sobre una línea concreta, no en abstracto.

Stack

• Backend: Ruby on Rails

• Autenticación: Devise (dashboard) · bearer token (API)

• Roles: administrador / cliente con implementación propia.

• Integraciones: sistema externo de activación · Google Sheets API

• Base de datos: PostgreSQL

• Jobs / colas: Sidekiq / Redis

• Despliegue: Ubuntu 24 / DigitalOcean.

• Idioma del producto: inglés

Resultados

La plataforma sustituyó un proceso manual sobre hojas de cálculo por un sistema con control de crédito, trazabilidad completa de cada movimiento y una API que permite a los distribuidores integrar la compra en sus propios sistemas.

Qué se llevó el cliente: Una plataforma que sabe en todo momento quién compró qué, con qué dinero y en qué estado quedó cada línea. En un negocio prepago, eso es el negocio.