Seu primeiro request

Vamos fazer a integração “dizer olá”. O objetivo aqui é só confirmar que sua credencial funciona e que você consegue autenticar — usando uma chamada somente leitura e sem efeito colateral: listar as linhas de crédito ativas do seu parceiro.

Obtenha um token


curl -X POST https://api.socinal.com.br/v1/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "cli_a1b2c3",
    "client_secret": "sk_live_..."
  }'

Guarde o access_token da resposta.

Liste as linhas de crédito


curl https://api.socinal.com.br/v1/linhas-credito \
  -H 'Authorization: Bearer SEU_TOKEN'

Resposta (exemplo):


[
  {
    "id": "3f1c...",
    "nome": "Consignado CLT",
    "taxa_mensal": 1.79,
    "prazo_min": 6,
    "prazo_max": 48,
    "ativo": true
  }
]

Guarde o id da linha de crédito que você vai usar — ele é exigido na simulação e na emissão do empréstimo.

Deu certo?

Se você recebeu a lista (mesmo que vazia), sua autenticação está funcionando. Agora vale entender o produto antes de originar de verdade:

Como funciona o crédito — o glossário e a lógica do consignado
Ciclo de vida da operação — a ordem das chamadas
Fluxo completo — o passo a passo ponta a ponta

Não funcionou?

Resposta	Provável causa
`401 CREDENCIAL_INVALIDA`	Token errado, expirado, ou faltou o header `Authorization`
`403 ESCOPO_INSUFICIENTE`	A credencial não tem o escopo `credito:read`
`429 RATE_LIMIT_EXCEDIDO`	Muitas chamadas — aguarde o tempo do `Retry-After`