Skip to main content
Quando o fluxo estiver validado no ambiente de testes, siga este checklist para começar a processar propostas reais.

Requisitos para produção

1

Valide o fluxo completo no staging

Rode pelo menos uma proposta de ponta a ponta na modalidade que você vai oferecer (financiamento, refinanciamento ou as duas).
2

Peça as credenciais de produção

Solicite o clientId e o clientSecret de produção em atendimento@credicarro.com.br, com a lista de lojas (CNPJ) que vão operar.
3

Aguarde a liberação

O time Credicarro libera a integração e vincula as lojas ao seu cadastro de parceiro.
4

Troque a base URL e as credenciais

Use https://api.credicarro.com.br/integration e as credenciais de produção.
5

Cadastre o webhook de produção

Os webhooks do staging não recebem eventos reais. Cadastre de novo a URL de produção e guarde o novo segredo_assinatura.

Checklist técnico

Antes de virar a chave

  • Base URL e credenciais vêm de configuração, não do código
  • clientSecret guardado em um gerenciador de segredos
  • Token reaproveitado em cache até perto de expira_em
  • Idempotency-Key gerada por operação e reaproveitada nas retentativas
  • Retentativa com espera crescente em 500, 502 e 503
  • Tratamento por tipo dos erros de negócio que o seu fluxo usa
  • Webhook em URL HTTPS pública, com assinatura HMAC validada e autenticação Basic ou JWT
  • Webhook responde 2xx rápido e processa de forma assíncrona
  • Notificações deduplicadas pelo Idempotency-Key, com a proposta consultada para obter o estado mais recente
  • Logs sem CPF completo, token, clientSecret ou conteúdo de documentos

Depois do go-live

Acompanhe as primeiras propostas

Confira se as etapas avançam e se os documentos estão sendo aceitos.

Monitore os webhooks

Depois de 3 retentativas, ou em respostas 4xx, a notificação deixa de ser enviada. Reconcilie consultando a proposta.

Precisa de ajuda?

Fale com o time Credicarro em atendimento@credicarro.com.br.