Central de ajuda

Como conectar a TotalPass à Zagu

Passo a passo para ligar seu studio à TotalPass: onde pegar a chave, onde colar na Zagu e como os check-ins chegam.

Atualizado em 14 de novembro de 2026

Com a integração, o check-in que o aluno da TotalPass faz no app chega sozinho à Zagu. A Zagu valida o check-in na TotalPass, sem você entrar no portal deles, e o aluno aparece no seu cadastro. Para ligar, você só precisa de uma coisa: a chave do seu studio na TotalPass (a place_api_key).

Antes de começar

  • Seu studio precisa estar cadastrado como parceiro da TotalPass.
  • Quem faz a ligação na Zagu precisa ter acesso a Configurações. Em geral, é o dono do studio.
  • Se você tem mais de um studio na Zagu, faça a ligação em cada um, com a chave de cada studio na TotalPass.

1. Pegue a chave do seu studio na TotalPass

A chave fica no portal da TotalPass para parceiros. É um código longo, de letras e números separados por hífens, no formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Copie a chave inteira, do primeiro ao último caractere.

Se não encontrar a chave no portal, peça ao seu contato na TotalPass a place_api_key do seu studio para integrar com a Zagu.

2. Cole a chave na Zagu

  1. Na Zagu, abra Configurações e, em “Comunicação e integrações”, clique em TotalPass.
  2. No campo Chave da unidade na TotalPass, cole a chave que você copiou.
  3. Clique em Conectar.

A Zagu confere a chave com a TotalPass na hora. Quando der certo, a situação muda para Funcionando. A partir daí, os check-ins dos alunos da TotalPass chegam à Zagu.

Se aparecer “chave da unidade inválida”, a chave foi copiada pela metade ou é de outro studio. Copie de novo e tente outra vez.

3. Escolha como os check-ins são validados

Na mesma tela, você decide:

  • Validar o check-in assim que ele chegar (vem ligado): a Zagu valida na TotalPass sozinha, e ninguém da recepção precisa fazer nada.
  • Desligado: cada check-in espera a recepção. Ele aparece no quadro Check-ins de parceiros, na tela inicial da Zagu, com os botões Confirmar e Descartar. Confirme quando o aluno chegar. O check-in que não é confirmado a tempo expira (a TotalPass dá cerca de 1 hora e meia), e um check-in expirado não é pago pela TotalPass.

4. Confira os planos da TotalPass

Em Configurações › TotalPass, na seção de planos, cada plano da TotalPass que dá direito ao seu studio vira um plano na Zagu. Quando chega o check-in de um plano novo, a Zagu cria o plano sozinha com valor zero. Abra o plano e preencha:

  • o valor: o quanto a TotalPass paga ao seu studio por check-in;
  • se o plano dá direito a uma sessão de aula, e em quais modalidades.

Com Lançar no financeiro ligado, cada check-in validado entra no financeiro como uma venda do plano da TotalPass, com o valor a receber no dia 15. Assim você confere o repasse da TotalPass mês a mês.

Como fica no dia a dia

  • O aluno faz o check-in no app da TotalPass, no seu studio.
  • Em poucos segundos, o check-in aparece no quadro Check-ins de parceiros, na tela inicial da Zagu. Com a validação automática, ele já aparece como Validado.
  • O aluno entra no seu cadastro de alunos com o selo Aluno TotalPass. Se ele já era seu aluno (mesmo CPF ou e-mail), a Zagu usa o cadastro que já existe, sem criar outro.
  • No perfil do aluno, a aba Frequência mostra todos os check-ins dele pela TotalPass.
  • Na lista de Alunos, o filtro Parceiro mostra só os alunos da TotalPass.

Por enquanto, a integração cuida dos check-ins. As reservas de aula feitas no app da TotalPass não passam pela Zagu.

Problemas comuns

  • A situação está “Com problema”. A mensagem na tela diz o motivo. Na maioria das vezes, a chave mudou na TotalPass: clique em Trocar a chave e cole a nova.
  • O aluno fez check-in, mas nada apareceu na Zagu. Confira se a situação está Funcionando e se o check-in foi feito no studio certo, no app da TotalPass. Se continuar, fale com a gente.
  • O check-in aparece como “Expirado”. Com a validação automática desligada, ele não foi confirmado a tempo. Para não perder check-ins, ligue a validação automática ou deixe a recepção de olho no quadro da tela inicial.
  • O check-in aparece como “Não validado”. A TotalPass recusou o check-in (por exemplo, o plano do aluno não dá direito ao seu studio). Nesse caso, o aluno não recebe plano nem cobrança na Zagu.

Como desligar

Em Configurações › TotalPass, clique em Desligar integração. Os check-ins da TotalPass deixam de chegar à Zagu até você conectar de novo. O histórico dos alunos continua no cadastro.

Também recebe alunos do Wellhub (Gympass)? Veja como conectar o Wellhub à Zagu.

Testar grátis por 7 dias