Skip to main content
Toda integração começa no staging: um ambiente isolado da produção, onde você testa o fluxo completo sem gerar propostas reais.
As credenciais e os webhooks de um ambiente não funcionam no outro. Um token de staging retorna 401 em produção.

​
Primeiros passos

1

Peça as credenciais de staging

Solicite o clientId e o clientSecret de staging em atendimento@credicarro.com.br. Peça também o cadastro da(s) loja(s) que você vai usar nos testes (cnpjLoja).
2

Gere um token

Use as credenciais em Gerar token de acesso.
3

Cadastre um webhook

Cadastre uma URL do tipo Proposta (tipo = 3) em Cadastrar webhook. Guarde o segredo_assinatura.
4

Rode o fluxo completo

Siga o guia de financiamento ou o de refinanciamento.
Para receber webhooks durante o desenvolvimento, exponha seu servidor local com uma ferramenta de túnel (como ngrok ou Cloudflare Tunnel) e cadastre a URL pública gerada.

​
O que testar

  • Token gerado e reaproveitado até perto de expirar
  • Cliente cadastrado com dados completos
  • Faixa e simulação com cnpjLoja
  • Proposta criada a partir de um id_simulacao
  • Documentos, dados do veículo e conta de recebimento enviados quando a etapa pedir
  • 400 com Validation.Cpf.Invalid ou Validation.LicensePlate.Invalid e o campo em campo
  • 404 com Store.Integration.NotFound (CNPJ não vinculado)
  • 422 com Customer.Account.Incomplete (cadastro incompleto)
  • 409 reutilizando uma Idempotency-Key com outro corpo
  • 401 com um token expirado
  • Assinatura X-CrediCarro-Signature validada contra o corpo bruto
  • Resposta 2xx em menos de 15 segundos
  • Deduplicação pelo header Idempotency-Key
  • Notificações fora de ordem tratadas consultando a proposta
  • Retentativa com a mesma Idempotency-Key após timeout
  • Espera crescente em 502 e 503

​
Próximo passo

Ir para produção

Quando o fluxo estiver validado, siga o checklist para processar propostas reais.

Precisa de ajuda?

Nossa equipe está disponível para ajudar no desenvolvimento. Escreva para atendimento@credicarro.com.br.