API Oficial

Integre crédito ao seu produto.

Este domínio é a base da API institucional da Negócio Certo. Abaixo, a estrutura preliminar de autenticação, endpoints e eventos.

Baixa latência

Infra edge-first

LGPD

Consentimento auditável

Bearer Auth

API Keys por ambiente

Webhooks

Eventos assinados HMAC

Base URL

https://api.negociocerto.com.br/v1

Autenticação

Todas as chamadas exigem um header Authorization: Bearer <API_KEY>. As chaves são emitidas por ambiente (sandbox e produção) mediante contrato de parceria.

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx
Content-Type: application/json
X-Idempotency-Key: 4d2a...

Endpoints

Método	Endpoint	Descrição
POST	/v1/credito/simular	Simulação de crédito por CPF/CNPJ, valor e parcelas.
POST	/v1/credito/propostas	Criação de proposta a partir de uma simulação aprovada.
GET	/v1/credito/propostas/{id}	Consulta o status atual de uma proposta.
POST	/v1/cadastro/consulta	Consulta de informações cadastrais autorizada pelo titular.
POST	/v1/cobranca/boletos	Emissão de boletos e réguas de cobrança.
POST	/v1/webhooks	Registro de URLs para eventos de proposta e contrato.

Exemplo — Simulação

curl -X POST https://api.negociocerto.com.br/v1/credito/simular \
  -H "Authorization: Bearer $NC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "documento": "000.000.000-00",
    "valor": 15000,
    "parcelas": 24,
    "produto": "credito_pessoal"
  }'

Webhooks

Eventos como proposta.aprovada, contrato.assinado e contrato.pago são notificados via POST com assinatura HMAC-SHA256 no header X-NC-Signature.

Documentação em evolução

A especificação OpenAPI completa e o portal do desenvolvedor serão publicados neste domínio. Solicite acesso antecipado e credenciais de sandbox.

Solicitar credenciais