Integración de Hubsoft con Surf Telecom

Acerca de Surf Telecom

Surf Telecom se presenta como un operador móvil 100% nacional, con una plataforma de BSS desarrollada internamente y presencia en todas las ciudades brasileñas. Tiene una solución para ISPs que ayuda al proveedor a evolucionar a operador de telefonía móvil, y una solución de operador white label para marcas.

Qué hace la integración

Hubsoft tiene dos gateways de Surf. El proveedor utiliza el que corresponde a la plataforma contratada.

Surf Connect:

• Planes consultados por chip: los planes de Surf Connect dependen de la SIM Card. Al registrar la línea, el agente informa el código de área y el ICCID, y Hubsoft busca en Surf los planes disponibles para ese chip.
• Activación: el agente elige el plan y guarda. Surf genera el número y Hubsoft lo registra después de la transmisión.
• Bloqueo y desbloqueo: la suspensión y habilitación del servicio en Hubsoft se envían a la cola de transmisión de Surf. Con la recurrencia activa, el plan también se bloquea o desbloquea según el pago de las facturas.
• Cambio de SIM Card y de titularidad: se realizan mediante las acciones del número, sin eliminar la línea.
• Portabilidad: se registra después de la activación, en las acciones del número.

Surf Pagtel:

• Sincronización de planes: los planes se incorporan a Hubsoft desde la pantalla de integración.
• Activación: el agente elige el plan y el código de área, e informa el ICCID. Surf genera el número.
• Línea principal: Surf Pagtel trabaja con una línea principal y líneas adicionales. El agente marca qué número es el principal, que es el que se factura.
• Estado de pago: una vez al día, Hubsoft informa a Surf si la factura del cliente está pagada. Surf se encarga del bloqueo y desbloqueo según este estado.
• Portabilidad: se registra en las acciones del número.

En ambos gateways, Hubsoft consulta el estado de la portabilidad cada hora, permite exigir un paquete por número para facturar la línea y muestra los errores de transmisión en el Informe MVNO.

Qué necesita

• Contrato con Surf y el token de autenticación, disponible en la plataforma de Surf, en el menú API > Documentación.
• Chips identificados por el ICCID.
• Los planes de Hubsoft que recibirán líneas deben tener marcada la opción "Servicio Permite MVNO".

Cómo activar

1. En Hubsoft, acceda a Configuración > Integraciones > MVNO > Agregar y seleccione Surf Connect o Surf Pagtel.
2. Ingrese el token y guarde.
3. En Surf Pagtel, sincronice los planes en Acciones > Planes > Sincronizar. En Surf Connect, los planes aparecen en el registro de cada línea.
4. En Configuración > General > Servicios / Planes, marque "Servicio Permite MVNO" en los planes que tendrán una línea móvil.
5. En el servicio del cliente, acceda a Otras opciones > Datos MVNO > Agregar e ingrese el código de área, el ICCID y el plan.

El paso a paso con las pantallas está en la wiki de Hubsoft: Surf Connect y Surf Pagtel.

Limitaciones

• En Surf Pagtel, Surf controla el estado de pago. Para cancelar, suspender o eliminar un plan manualmente, el proveedor también debe comunicar la cancelación a Surf.
• En Surf Pagtel, solo un número del cliente puede marcarse como principal.
• En Surf Connect, no hay una lista previa de planes: dependen del ICCID informado.

Preguntas frecuentes

¿Qué gateway debo elegir?

El que corresponda a la plataforma contratada con Surf. En caso de duda, confirme con Surf si su cuenta es Surf Connect o Surf Pagtel.

Si el servicio del cliente se suspende por falta de pago, ¿también se suspende la línea?

En Surf Connect, sí: la suspensión se envía a la cola de bloqueo. En Surf Pagtel, Hubsoft envía el estado de pago una vez al día y Surf realiza el bloqueo.

¿Por qué Surf Connect no muestra los planes en la pantalla de integración?

Porque los planes dependen de la SIM Card. Aparecen en el registro de la línea después de que el agente informa el ICCID.

Revisado el 10/10/2026.