Central de ajuda › Financeiro e CRM

Conectar Wellhub e TotalPass

Como cadastrar seu Gym ID, validar check-ins em tempo real, configurar geofence e proteger repasses financeiros.

As integrações com agregadores são opcionais

Sua academia não precisa ser credenciada ao Wellhub ou ao TotalPass para utilizar o E-Fit Core: todos os módulos de alunos, mensalidades, catracas, treinos e agenda funcionam de forma 100% autônoma. Conecte apenas se a sua unidade for parceira dessas plataformas.

Onde encontrar e configurar as credenciais

Para conectar, acesse Minha conta → Integrações (exclusivo para perfil de Proprietário):

  • Wellhub (antigo Gympass): Você só precisa informar o Gym ID da sua unidade (código numérico fornecido no portal do parceiro Wellhub). A chave de integração global é gerenciada pelo E-Fit Core, dispensando configurações técnicas complexas.
  • TotalPass: No Portal de Academias TotalPass, acesse Integrações, selecione o integrador MagSi Tech / E-Fit Core e copie a API Key da unidade (place_api_key) gerada. Cole a chave no E-Fit Core (o código da unidade é identificado automaticamente ou pode ser informado manualmente, aceitando letras e números).

Conferência de segurança do Gym ID

Ao cadastrar um Gym ID pela primeira vez, o status pode constar temporariamente como Em verificação. Nossa equipe técnica valida junto à base oficial se o identificador corresponde exatamente à sua razão social antes de iniciar o processamento dos repasses.

Como funciona a validação antifraude de check-ins

Cada check-in realizado por um usuário nos aplicativos de terceiros é auditado pelo E-Fit Core antes de ser computado como repasse financeiro válido:

  1. Janela de validade temporal: Bloqueia check-ins efetuados muito antes do horário de funcionamento ou em datas retroativas;
  2. Duplicidade: Impede que o mesmo usuário gere dois check-ins no mesmo dia para inflar repasses indevidamente;
  3. Geolocalização (Geofence): Compara a posição GPS do celular do usuário no momento do check-in com as coordenadas físicas da sua academia;
  4. Status do convênio: Valida se o plano do aluno no agregador possui autorização para a modalidade que ele pretende praticar.

Modo Rigoroso vs. Modo Alerta

Na tela de configurações da unidade, você escolhe como o sistema deve reagir caso um check-in apresente divergências:

  • Modo Alerta (Recomendado nas primeiras semanas): O check-in é aceito para não causar atrito no balcão, mas fica sinalizado em amarelo no Dashboard para que a gerência confira a situação;
  • Modo Rigoroso: O check-in divergente é recusado de imediato na catraca, protegendo a academia contra prejuízos em repasses não homologados.

Dúvidas frequentes

  • O aluno fez o check-in no aplicativo do Wellhub, mas a catraca não liberou: Verifique se o CPF ou Gympass ID do aluno cadastrado no sistema bate exatamente com o usuário do app. Caso o check-in tenha sido rejeitado, abra o Dashboard para ver o motivo (ex: duplicidade ou fora da janela de horário).
  • Como conferir o total de repasses do mês: Acesse o menu Relatórios → Check-ins de Agregadores para exportar a listagem consolidada de acessos aprovados por período.

Atualizado em 2026-10-15.