Primeiros Passos

Visão geral

O Webservice de Parceiros ClubFix é uma API REST que permite a parceiros habilitados:

Cotar e contratar proteções para dispositivos (smartphones, notebooks, tablets)
Gerenciar clientes e seus contratos
Processar ou notificar pagamentos
Acompanhar o ciclo de vida de assinaturas e planos anuais

Para utilizar esta API você precisa ser um parceiro habilitado. Solicite suas credenciais ao time de suporte ClubFix.

1. Autenticar

Todas as requisições exigem um token Bearer. Obtenha-o com suas credenciais de parceiro:

curl -X POST "https://homolog.clubfix.com.br/webservice/auth/login" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"email": "seu@email.com", "password": "suasenha"}'

Resposta:

{
  "token": "eyJ0eXAiOiJKV1Q...",
  "token_type": "Bearer"
}

Use o token retornado no header Authorization: Bearer {token} em todas as chamadas seguintes.

2. Localizar o dispositivo

Antes de cotar, você precisa do ID do modelo do dispositivo:

# Listar marcas
curl -X GET "https://homolog.clubfix.com.br/webservice/brands" \
  -H "Authorization: Bearer {token}"

# Listar modelos de uma marca
curl -X GET "https://homolog.clubfix.com.br/webservice/models?brand_id=1" \
  -H "Authorization: Bearer {token}"

Guarde o id do modelo — você vai usá-lo na cotação.

3. Escolher o produto

ClubFix oferece dois tipos de produto:

Produto	Duração	Ideal para
Plano Anual	12 meses (pagamento único)	Contratações pontuais, loja física
Assinatura	Mensal recorrente	Plataformas digitais, e-commerce

4. Cotar

Plano Anual
Assinatura

curl -X GET "https://homolog.clubfix.com.br/webservice/annual-plans/quote?model_id=42" \
  -H "Authorization: Bearer {token}"

Resposta inclui premium (prêmio anual) e lmi (limite máximo de indenização).

curl -X GET "https://homolog.clubfix.com.br/webservice/quotation?model_id=42" \
  -H "Authorization: Bearer {token}"

Retorna todos os planos disponíveis com monthly_premium e lmi para cada um.

5. Contratar

Plano Anual
Assinatura

curl -X POST "https://homolog.clubfix.com.br/webservice/annual-plans" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": 42,
    "customer_document": "123.456.789-00"
  }'

curl -X POST "https://homolog.clubfix.com.br/webservice/subscriptions" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": 42,
    "customer_document": "123.456.789-00",
    "plan_id": 7
  }'

Próximos passos

Fluxo Completo — Assinatura

Sequência end-to-end: cotação → contratação → parcelas → ativação

Fluxo Completo — Plano Anual

Sequência end-to-end: cotação → contratação → pagamento → ativação

Controle de LMI

Como usar o campo maxima para personalizar o limite de cobertura

Roadmap

SDKs para Node.js e PHP, conector n8n e próximas integrações

Visão Geral

Guias de Integração

Autenticação

Clientes

Dispositivos

Assinaturas

Planos Anuais

Lojistas

Visão geral

1. Autenticar

2. Localizar o dispositivo

3. Escolher o produto

4. Cotar

5. Contratar

Próximos passos

Fluxo Completo — Assinatura

Fluxo Completo — Plano Anual

Controle de LMI

Roadmap

​Visão geral

​1. Autenticar

​2. Localizar o dispositivo

​3. Escolher o produto

​4. Cotar

​5. Contratar

​Próximos passos

Fluxo Completo — Assinatura

Fluxo Completo — Plano Anual

Controle de LMI

Roadmap

Visão geral

1. Autenticar

2. Localizar o dispositivo

3. Escolher o produto

4. Cotar

5. Contratar

Próximos passos