Integração Hubsoft com PlayHub

Sobre a PlayHub

A PlayHub fornece serviços de valor agregado para provedores de internet: conteúdo de streaming e aplicativos para toda a família, além de aplicativos personalizados. O catálogo inclui apps de leitura, infantis, de bem-estar, de segurança e de vídeo, que o provedor revende aos assinantes junto com a internet.

O que a integração faz

A integração usa a API da PlayHub. Com ela, o Hubsoft faz:

• Cadastro do assinante e dos produtos na PlayHub quando o pacote é vinculado a um serviço habilitado, ou quando o serviço é habilitado.
• Remoção dos produtos quando o pacote sai do serviço.
• Suspensão e reativação conforme o cliente fica inadimplente ou volta a pagar, com a opção Habilitar/Suspender Assinaturas ligada.
• Consulta do cadastro antes de cada envio: se o produto já está com o cliente, o Hubsoft não pede de novo; se já foi removido, não pede a remoção.
• Envio do e-mail e do celular do cadastro, com opção de informar outros no pacote.
• Atualização dos cadastros que já existem na plataforma, se o provedor ligar essa opção.

A PlayHub trabalha com dois tipos de produto:

• Tradicional: o assinante recebe exatamente os apps que o provedor vendeu.
• Portal do assinante: o pacote leva um código com a quantidade de escolhas, e o assinante escolhe os apps no portal da PlayHub. Há códigos para serviços comuns, para serviços premium e um código próprio para o Deezer. A lista de apps de cada código está na wiki.

O login e a senha iniciais seguem um dado do cadastro. O padrão é o CPF ou CNPJ do assinante; também pode ser o login de autenticação, o código do cliente, o e-mail ou o telefone.

O que você precisa

• Contrato com a PlayHub.
• A api_key e a api_secret, fornecidas pela PlayHub.
• Os produtos combinados com a PlayHub, com nome, código e descrição. A comercialização muda de provedor para provedor.

Como ativar

1. No Hubsoft, acesse Configuração > Integrações > Plataformas de Conteúdo, clique em Adicionar e selecione a PlayHub.
2. Preencha a api_key e a api_secret e, se quiser, o dado usado como login.
3. Defina se vai usar pacote único, que libera tudo, e ligue a opção Habilitar/Suspender Assinaturas.
4. Use Ações > Testar para validar.
5. Em Ações > Produtos, cadastre os produtos com os códigos combinados com a PlayHub.
6. Em Configuração > Geral > Pacotes, crie o pacote com valor e composição fiscal e, na aba Integração, escolha a PlayHub e o produto.
7. Vincule o pacote ao serviço do cliente ou ao plano.

O passo a passo com as telas está na página da PlayHub na wiki da Hubsoft.

Limitações

• O assinante é identificado pelo CPF ou CNPJ. Por isso, o pacote com integração deve ficar em um só plano do cliente. Para cobrar o mesmo valor em outro plano, use um pacote igual sem integração.
• O cliente pode ter um só produto de múltipla escolha. Tentar somar um segundo código de escolhas dá erro na PlayHub.
• Provedores no modelo de portal do assinante não devem cadastrar produtos do tipo tradicional, ou a transmissão falha.
• Se o assinante já tem cadastro ativo na PlayHub, o Hubsoft não sobrescreve os dados dele, a menos que a atualização esteja ligada.

Perguntas frequentes

Posso mudar o login e a senha do assinante na PlayHub?

Sim. Na integração, o parâmetro de usuário define o dado usado como login e senha. O padrão é o CPF ou CNPJ.

Deu erro ao transmitir o pacote. Como descobrir o motivo?

Abra as Ações do pacote no serviço do cliente e clique em Erro. A mensagem mostra o que impediu o envio. Se não ficar claro, chame o suporte da Hubsoft.

Posso dar a PlayHub de cortesia?

Sim. O pacote pode ter valor zerado e ser incluído no plano como benefício.

Revisado em 10/10/2026.