> ## Documentation Index
> Fetch the complete documentation index at: https://documentacao.credicarro.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Perguntas frequentes

> Dúvidas comuns de lojistas e desenvolvedores sobre a Credicarro

## Para lojistas

> **Qual a diferença entre financiamento e refinanciamento?**
>
> **Financiamento** é para o cliente comprar um veículo na sua loja. **Refinanciamento** é para o cliente conseguir crédito usando um veículo que já é dele como garantia. Veja [Financiamento](https://documentacao.credicarro.com.br/pages/concepts/financing.md) e [Refinanciamento](https://documentacao.credicarro.com.br/pages/concepts/refinancing.md).

> **O cliente precisa dar entrada no financiamento?**
>
> Não é obrigatório — a entrada pode ser zero. Mas cada prazo tem uma **entrada mínima**, que pode ser consultada antes da simulação, e a entrada precisa deixar pelo menos 10% do valor do veículo para financiar.

> **Quanto o cliente consegue no refinanciamento?**
>
> Depende do veículo. A **faixa refinanciável** mostra, para cada prazo, o valor mínimo e o máximo que a placa permite.

> **Por que a simulação foi recusada para a minha loja?**
>
> A loja precisa estar vinculada ao integrador que está fazendo a simulação. Lojas com contrato de intermediação também não simulam pela integração. Fale com o time Credicarro para revisar o cadastro.

> **Um documento foi recusado. E agora?**
>
> Veja o motivo da recusa, corrija com o cliente e reenvie **só aquele documento**. Veja [Documentos](https://documentacao.credicarro.com.br/pages/concepts/documents.md).

> **O cliente não fez a biometria. O que acontece?**
>
> A biometria é a última etapa antes do pagamento: sem ela, a proposta não é paga. A Credicarro envia o link ao cliente por WhatsApp e e-mail na aprovação — lembre o cliente de acessá-lo. Se a biometria for reprovada, a etapa fica bloqueada — fale com o time Credicarro.

> **Posso usar a conta bancária de outra pessoa no refinanciamento?**
>
> Não. A conta de recebimento precisa estar no CPF do próprio cliente da proposta.

> **A proposta expirou. Dá para retomar?**
>
> A proposta expira um mês depois de criada, se não for concluída. Uma proposta expirada não continua: faça uma nova simulação e crie uma nova proposta.

***

## Para desenvolvedores

> **Preciso de um token para cada rota?**
>
> Não. O token gerado em `POST /v1/authentication/accesstoken` vale para todas as rotas da API até expirar.

> **Recebo 404 em uma proposta que existe**
>
> Confira se o token é do mesmo ambiente (staging ou produção) em que a proposta foi criada. A API também retorna 404 para recursos de outro parceiro.

> **Como sei o que enviar em cada etapa?**
>
> Consulte a proposta (ou use o webhook de proposta) e olhe o `status_ativo` do comprador e da loja. Quando `responsavel_acao` for `INTEGRADOR`, a `etapa` diz qual endpoint chamar. Veja [Etapas e status](https://documentacao.credicarro.com.br/pages/v2/steps.md).

> **Preciso consultar a proposta o tempo todo?**
>
> Não. Cadastre um webhook do tipo Proposta (`tipo` = 3) e reaja às notificações. Use a consulta só para reconciliar ou quando precisar do estado mais recente.

> **Posso repetir uma requisição que deu timeout?**
>
> Sim, com segurança, se você enviar o header `Idempotency-Key`. Repetir a mesma chave com o mesmo corpo devolve o resultado original. Veja [Erros e idempotência](https://documentacao.credicarro.com.br/pages/errors.md).

> **Perdi o segredo de assinatura do webhook**
>
> O `segredo_assinatura` só aparece na resposta do cadastro. Exclua o webhook e cadastre outro para gerar um novo segredo.

> **As credenciais de staging funcionam em produção?**
>
> Não. Cada ambiente tem o seu `clientId` e `clientSecret`. Veja [Ir para produção](https://documentacao.credicarro.com.br/pages/production.md).

> **[Não achou a resposta?](mailto:atendimento@credicarro.com.br)**
>
> Fale com o time Credicarro em [atendimento@credicarro.com.br](mailto:atendimento@credicarro.com.br).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.