FortunCredPORTAL DO DESENVOLVEDOR Gerar API Key
API de crédito imobiliário para parceiros

Coloque o crédito imobiliário da FortunCred dentro do seu sistema.

Uma API só: cadastre o lead, simule o financiamento, envie para análise de crédito e acompanhe o resultado — como se fosse o seu próprio produto.

Começar → Ver a Referência

Para quem é

Imobiliárias, correspondentes e plataformas que querem oferecer crédito imobiliário ao cliente sem sair do próprio sistema — de forma automatizada e white-label, como se o crédito fosse um recurso nativo do produto deles.

Você opera sempre no contexto da sua unidade (definida na API Key). Não precisa acessar o sistema interno da FortunCred: a API é a ponte. Comunicação por HTTPS, respostas em JSON.

Integre em 3 passos

Sem certificado digital, sem OAuth complexo. Só uma API Key e você já está integrando.

1

Receba sua chave de teste

No painel /admin, o gestor cria a chave do parceiro. Toda chave nova começa como teste (sandbox) — você recebe uma fortuncred_sandbox_….

2

Faça a primeira chamada

Cadastre um lead e rode uma simulação com X-API-Key no header. Em minutos você tem taxas e parcelas de vários bancos.

3

Receba o resultado

Envie para análise e acompanhe por polling ou receba um webhook assinado quando o banco aprovar/recusar.

O que a API faz

Quatro recursos que cobrem o funil inteiro do crédito imobiliário.

👤

Leads

Cadastre ou reaproveite o cliente (dedup por CPF). O lead é a fonte de verdade dos dados do titular.

POST /v1/leads · PATCH /v1/leads/:id
🧮

Simulação

Simule o financiamento em vários bancos de uma vez e receba taxas, parcelas e CET em JSON.

POST /v1/simulacoes
✅

Análise de crédito

Envie a ficha completa para aprovação real no banco — com consentimento LGPD e idempotência.

POST /v1/analises
📡

Acompanhamento

Consulte o status normalizado da análise (enum estável) ou receba por webhook quando resolver.

GET /v1/analises/:id/status

Feita para integrar rápido

  • Autenticação simples — só X-API-Key. Sem certificado mTLS.
  • Idempotência — reenvio seguro, sem análise duplicada.
  • Consentimento LGPD — trilha de auditoria embutida.
  • Webhooks assinados — HMAC-SHA256 em cada entrega.
  • Erros com código estável — você ramifica por codigo, não pela mensagem.
Primeira chamada
# cria (ou reaproveita) um lead
curl -X POST https://developers.fortuncred.com.br/v1/leads \
  -H "X-API-Key: fortuncred_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{"nome":"Maria Silva","cpf":"529.982.247-25"}'

# resposta
{ "ok": true, "lead_id": 34077, "reaproveitado": false }
Ver o guia completo →

Restrições de uso

  • API Key com escopos (lead, simulação, análise, acompanhamento).
  • Rate limit por parceiro (padrão 120 req/min).
  • Homologação obrigatória: tudo começa no sandbox; produção só após validar o fluxo.
  • Consentimento LGPD do titular na análise de crédito.
  • Comunicação apenas por HTTPS.

Conhecimentos necessários

Basta estar familiarizado com HTTP e JSON:

RESTHTTPSJSON API KeyWebhooksPostmanInsomnia

Não é preciso certificado digital nem OAuth — só a API Key. Ferramentas como Postman/Insomnia ajudam a testar.

Tempo aproximado para integração

Minutos para a primeira chamada no sandbox — basta a chave de teste, sem certificado digital.
1 a 3 dias para a integração completa, conforme o tamanho do time e a experiência.
Gerar API Key Referência da API