FortunCredPORTAL DO DESENVOLVEDOR
Gerar API Key
FortunCredPORTAL DO DESENVOLVEDOR
Gerar API Key
Precisa de ajuda com a integração? Comece pelos guias, cheque o status e, se precisar falar com a gente, tenha o request_id em mãos.
integracao@pcapitalassessoria.com.br
resposta em até 1 dia útil
Procure o consultor que te atende na FortunCred.
GET /health — retorna ok, version e uptime_s em tempo real.
request_id que veio na resposta de erro — é com ele que rastreamos a chamada exata nos nossos logs. Nunca inclua a sua API Key nem dados sensíveis do cliente (CPF, renda) na mensagem.A chave é gerada pelo gestor no painel /admin, vinculada à sua unidade (e opcionalmente a um consultor). Você recebe uma chave no formato fortuncred_…. O parceiro não gera a própria chave — é sempre pelo gestor.
Não. A autenticação é só a API Key no header X-API-Key. Sem certificado mTLS, sem fluxo OAuth — você integra em minutos.
Avise o gestor: ele rotaciona a chave no painel e a antiga para de valer imediatamente. Trate a API Key como segredo — guarde em variável de ambiente, nunca no front-end.
Não. O POST /v1/leads faz dedup por CPF: se o lead já existe, ele é reaproveitado (a resposta traz reaproveitado: true) e as simulações/análises ficam salvas dentro dele.
Não, se você usou a mesma Idempotency-Key. A API devolve a resposta original (Idempotent-Replay: true). Corpo diferente com a mesma chave retorna 422 idempotency_conflito.
Duas formas: polling em GET /v1/analises/:id/status até pendente: false, ou webhook — a FortunCred te avisa em analise.resultado assim que o banco decide. Veja Webhooks.
Você atingiu o rate limit. Respeite o header Retry-After (segundos) e tente de novo. O padrão é 120 req/min por parceiro.
Sim — o Sandbox exercita o fluxo inteiro sem enviar nada aos bancos, com CPFs de teste que forçam cada desfecho (aprovado/condicionado/recusado).