Quais são as etapas para se integrar à TotalPass?

Para garantir uma conexão segura e uma experiência fluida tanto para os desenvolvedores quanto para as academias parceiras, a jornada de integração do seu sistema (ERP) com a TotalPass ocorre em quatro grandes etapas.

Abaixo, detalhamos o caminho que o seu time de tecnologia irá percorrer do início ao fim:

1. Alinhamento e Credenciais (Termo de Adesão)

O primeiro passo é formalizar a nossa parceria através do Termo de Adesão. Sem ele, não é possível iniciar o desenvolvimento.

• Onde e como solicitar o termo? Você deve enviar um e-mail diretamente para tp.integracoes@totalpass.com.br contendo os dados da sua empresa: 

  • Nome do ERP (Como deve ser exibido para as academias e em nosso Portal)

  • Razão Social e CNPJ

  • Nome completo e e-mail do responsável legal.

  • Quais APIs serão integradas (Booking, Validação ou ambas).

• Recebimento das Credenciais (API Keys) para desenvolvimento: Nossa equipe responderá com o termo. Após a assinatura, você receberá a documentação técnica oficial da API e suas credencias de acesso (partner_api_key e uma place_api_key de testes).

2. Desenvolvimento da Integração

Com as credenciais e a documentação técnica em mãos, o seu time iniciará o desenvolvimento do código. Vocês poderão construir as rotas utilizando a API de Validação de Check-in (focada em catracas e liberação de acesso), a API de Booking (focada em agendamentos de aulas e reservas), ou ambas, de acordo com o modelo de negócio do seu sistema.

3. Criação do Usuário de Testes

Quando a integração estiver finalizada do seu lado a nível de código, é hora de prepararmos o terreno para a validação. A TotalPass não possui um ambiente de Sandbox separado; portanto, todo o desenvolvimento e os testes ocorrem diretamente em nosso ambiente de produção.

Para testar com segurança, você deverá nos enviar os dados de uma pessoa real para criarmos um perfil de testes oficial. Envie para tp.integracoes@totalpass.com.br os seguintes dados:

• Nome completo

• CPF (⚠️ Atenção: este CPF não pode ter cadastro prévio na TotalPass)

• E-mail

• Endereço físico (⚠️ Importante: este endereço precisa ser num raio de até 200 metros do local onde você fará o teste prático de check-in, para que a validação de geolocalização do app funcione corretamente).

4. Homologação e Testes

Com o seu usuário de testes criado e o plano ativado no app da TotalPass pela nossa equipe, o seu time poderá realizar a validação prática. Vocês simularão o fluxo exato que um aluno faria: realizando o check-in na unidade de teste e/ou agendando aulas, para garantir que o seu ERP receba os webhooks e libere o acesso corretamente.

⚠️ Qual é o ambiente de homologação? A TotalPass não possui um ambiente de Sandbox separado. Todo o desenvolvimento e validação ocorrem diretamente em nosso ambiente de produção. Por isso, é necessário solicitar a criação de um usuário de testes exclusivo para o seu time validar os fluxos com segurança. Solicite a criação desse usuário através do nosso e-mail de suporte (informando Nome, CPF sem cadastro prévio e E-mail).

5. Lançamento e Disponibilização (Go-Live)

Depois que os testes forem executados e a integração for validada com sucesso pela nossa equipe técnica, a sua solução estará pronta para ir ao ar!

O nome do seu sistema será adicionado à lista oficial de integrações homologadas dentro do Portal da TotalPass. A partir desse momento, para que os seus clientes comecem a usar a automação, o fluxo é simples:

1. A academia acessa o Portal de Parceiros da TotalPass.

2. Navega até a aba "Integrações", depois "Configurar integrações".

3. Seleciona o seu ERP na lista e gera a place_api_key (chave da unidade).

4. A API Key deverá ser compartilhada com o ERP.