Integração Hubsoft com Surf Telecom

Sobre a Surf Telecom

A Surf Telecom se apresenta como operadora móvel 100% nacional, com plataforma de BSS desenvolvida internamente e presença em todas as cidades brasileiras. Tem uma solução para ISPs, que ajuda o provedor a evoluir para operadora com telefonia móvel, e uma solução de operadora white label para marcas.

O que a integração faz

O Hubsoft tem dois gateways da Surf. O provedor usa o que corresponde à plataforma contratada.

Surf Connect:

• Planos consultados pelo chip: os planos da Surf Connect dependem do SIM Card. No cadastro da linha, o atendente informa o DDD e o ICCID, e o Hubsoft busca na Surf os planos disponíveis para aquele chip.
• Ativação: o atendente escolhe o plano e salva. A Surf gera o número, e o Hubsoft o grava no cadastro depois da transmissão.
• Bloqueio e desbloqueio: a suspensão e a habilitação do serviço no Hubsoft vão para a fila de transmissão da Surf. Com a recorrência ativa, o plano também é bloqueado ou desbloqueado conforme o pagamento das faturas.
• Troca de SIM Card e de titularidade: feitas pelas ações do número, sem apagar a linha.
• Portabilidade: cadastrada depois da ativação, nas ações do número.

Surf Pagtel:

• Sincronização de planos: os planos são trazidos para o Hubsoft pela tela da integração.
• Ativação: o atendente escolhe o plano e o DDD e informa o ICCID. A Surf gera o número.
• Linha principal: a Surf Pagtel trabalha com linha principal e linhas adicionais. O atendente marca qual número é o principal, que é o faturado.
• Status de pagamento: uma vez por dia, o Hubsoft informa à Surf se a fatura do cliente está paga. O bloqueio e o desbloqueio ficam com a Surf, a partir desse status.
• Portabilidade: cadastrada nas ações do número.

Nos dois gateways, o Hubsoft consulta o status da portabilidade a cada hora, permite exigir um pacote por número para faturar a linha e mostra os erros de transmissão no Relatório MVNO.

O que você precisa

• Contrato com a Surf e o token de autenticação, disponível na plataforma da Surf, no menu API > Documentação.
• Chips identificados pelo ICCID.
• Os planos do Hubsoft que vão receber linhas marcados com a opção "Serviço Permite MVNO".

Como ativar

1. No Hubsoft, acesse Configuração > Integrações > MVNO > Adicionar e selecione Surf Connect ou Surf Pagtel.
2. Informe o token e salve.
3. Na Surf Pagtel, sincronize os planos em Ações > Planos > Sincronizar. Na Surf Connect, os planos aparecem no cadastro de cada linha.
4. Em Configuração > Geral > Serviços / Planos, marque "Serviço Permite MVNO" nos planos que terão linha móvel.
5. No serviço do cliente, acesse Outras Opções > Dados MVNO > Adicionar e informe o DDD, o ICCID e o plano.

O passo a passo com as telas está na wiki da Hubsoft: Surf Connect e Surf Pagtel.

Limitações

• Na Surf Pagtel, a adimplência é controlada pela Surf. Para cancelar, suspender ou apagar um plano manualmente, o provedor também precisa comunicar a desistência à Surf.
• Na Surf Pagtel, só um número do cliente pode ser marcado como principal.
• Na Surf Connect, não há lista prévia de planos: eles dependem do ICCID informado.

Perguntas frequentes

Qual gateway devo escolher?

O que corresponde à plataforma contratada com a Surf. Na dúvida, confirme com a Surf se a sua conta é Surf Connect ou Surf Pagtel.

Se o serviço do cliente for suspenso por débito, a linha também é suspensa?

Na Surf Connect, sim: a suspensão vai para a fila de bloqueio. Na Surf Pagtel, o Hubsoft envia uma vez por dia o status de pagamento e a Surf faz o bloqueio.

Por que a Surf Connect não mostra os planos na tela da integração?

Porque os planos dependem do SIM Card. Eles aparecem no cadastro da linha, depois que o atendente informa o ICCID.

Revisado em 10/10/2026.