Ambiente de homologação para integradores. Escolha seu perfil abaixo —
Academia (parceira que recebe o check-in dos alunos) ou Empresa (benefício
corporativo aos colaboradores) — e teste a integração sem tocar em produção.
URLs base da integração
Aponte sua integração para o ambiente certo. As credenciais do sandbox são geradas aqui; as de produção, após aprovação.
SANDBOXhttps://sandbox-api.pripass.comHomologação — ambiente de teste isolado, dados efêmeros e sem cobrança.
PRODUÇÃOhttps://api.pripass.comProdução — use somente com credenciais aprovadas e dados reais.
Convenção de rotas — Academia: caminhos sem prefixo, ex. /partner/auth e /v1/track_usages (autentica com place + partner key → JWT; check-in usa x-api-key). Empresa: caminhos sob /api/… com token Bearer.
Criar meu ambiente de teste
Ambiente de teste pronto
Aponte sua integração para a base_url acima e use estas credenciais.
Expira em .
Testar o fluxo agora
Executa as chamadas reais contra o sandbox, na ordem do fluxo de check-in.
1
Autenticar— troca as 2 chaves por um JWT.
2
Validar elegibilidade— não consome (204 = elegível).
3
Registrar check-in— consome (204) e dispara o webhook.
Ou copie e cole (cURL)
Endpoints da API Academia
Fluxo de check-in no padrão de mercado. Principais grupos:
Autenticação
POST/partner/auth Troca as 2 chaves por um token (JWT)
Check-in (uso)
POST/v1/track_usages/validate Valida a elegibilidade (não consome)
POST/v1/track_usages Registra o check-in (consome e dispara o webhook)
POST/v1/track_usages/beneficiaries/code Resolve o beneficiário por código
POST/partner_app/v1/validate Valida o check-in pelo app da academia
Planos
GET/partner/plans Lista os planos disponíveis
Webhooks
POST/partner/webhook/create Cria uma assinatura de webhook
GET/partner/webhook Lista os webhooks
PUT/partner/webhook/update Atualiza um webhook
DEL/partner/webhook Remove um webhook
Agenda & lugares+ eventos, ocorrências, slots e mapas de assento
GET/partner/events Lista os eventos da agenda
GET/partner/slot Consulta os slots (vagas)
Endpoints e corpos completos estão na documentação da API Academia.
Criar meu ambiente de teste — Empresa
Gera na hora uma empresa de homologação com CNPJ (identifier) + auth_token e 3 funcionários elegíveis. Use as chaves para autenticar em /api/v1/login e consultar a elegibilidade dos colaboradores.
Ambiente de teste pronto
Autentique em POST /api/v1/login com identifier + auth_token. Expira em .
Testar o fluxo agora
Executa as chamadas reais contra o sandbox, na ordem do fluxo B2B.
1
Autenticar— identifier (CNPJ) + auth_token → JWT.
2
Perfil do grupo— nº de colaboradores elegíveis salvos.
3
Elegibilidade— checa um funcionário do grupo (deve ser elegível).
Ou copie e cole (cURL)
Integração Empresa (B2B)
Existem dois caminhos no lado Empresa. Integração por chave (company_group) — o cadastro self-service acima, autentica com identifier + auth_token; ideal para um parceiro consultar elegibilidade. API nativa /api/companies (abaixo) — gestão completa da empresa (membros, carteira, cobrança), autentica com login de usuário (JWT do dono da empresa) e não é provisionada por este cadastro de teste.
Sua empresa oferece o PriPass como benefício aos
colaboradores. A integração Empresa é mais ampla que a de Academia: além do acesso, você
gerencia o cadastro da empresa, os membros, a carteira de créditos e os relatórios de uso.
1
Cadastrar a empresa— crie o grupo empresarial, ajuste dados e acompanhe o dashboard.
2
Gerir membros— adicione colaboradores um a um ou importe em lote por CSV; suspenda ou reative.
3
Carteira & relatórios— recarregue saldo (Stripe), distribua créditos e puxe coparticipação e relatórios de uso.
Endpoints da API Empresa
Base /api/companies · muito mais amplo que o fluxo de check-in da Academia. Principais grupos:
Empresa
POST/api/companies Cria a empresa (grupo)
GET/api/companies/my Lista as empresas do usuário
GET/api/companies/{id} Detalhes da empresa
PATCH/api/companies/{id} Atualiza dados da empresa
GET/api/companies/{id}/dashboard Dashboard com indicadores
Membros
GET/api/companies/{id}/members Lista os membros
POST/api/companies/{id}/members Adiciona um membro
POST/api/companies/{id}/members/bulk Importa membros em lote (CSV)
DEL/api/companies/{id}/members/{memberId} Remove um membro
Carteira & créditos
POST/api/companies/{id}/recharge Recarrega o saldo da empresa (Stripe)
POST/api/companies/{id}/allocate Distribui créditos aos membros
POST/api/companies/use-credit Usa crédito da empresa para assinar um plano
Painel corporativo+ funcionários, coparticipação, bônus, cobrança e domínio
GET/api/company/reports Relatórios de uso e check-ins
POST/api/company/employees/import Importa funcionários em lote
GET/api/company/billing Fatura corporativa e pagamento
Exemplo (cURL)
# 1) Criar a empresa (grupo)
curl -X POST https://sandbox-api.pripass.com/api/companies \
-H 'Authorization: Bearer SEU_TOKEN' -H 'Content-Type: application/json' \
-d '{"name":"Minha Empresa","document":"12345678000190"}'
# 2) Importar membros em lote (CSV)
curl -X POST https://sandbox-api.pripass.com/api/companies/<id>/members/bulk \
-H 'Authorization: Bearer SEU_TOKEN' -F '[email protected]'
Os corpos exatos de cada requisição estão na documentação da API Empresa.
Endpoints — Integração por chave (company_group)
Fluxo B2B no padrão de mercado que as chaves acima destravam. Autentica com identifier + auth_token → Bearer JWT; a analítica usa x-api-key: <auth_token>.
priPass
Developers
