Desembolsar

POST/v1/emprestimos/{id}/desembolso

🔒 Requer Bearer token

Escopo desembolso:write. Requer header Idempotency-Key (move dinheiro). Não recebe dados: o corpo é um objeto vazio {} (opcional). O empréstimo precisa estar averbada (averbação é passo interno da Socinal). A chamada solicita o pagamento PIX no BaaS Socinal e o empréstimo passa a desembolso_agendado; a **data efetiva do pagamento é definida pelo BaaS** (não é escolhida na chamada). A confirmação do PIX é assíncrona (webhook do BaaS) e só então o empréstimo vira desembolsada — acompanhe pelos webhooks desembolso.liquidado / desembolso.falhou. Regras do BaaS Socinal que impeçam a liquidação retornam 422 ERRO_NEGOCIO com o motivo; indisponibilidade real retorna 502.

Parâmetros

idstringpathobrigatório

Respostas

200Desembolso solicitado (status `desembolso_agendado`).

400Header `Idempotency-Key` ausente (`IDEMPOTENCY_KEY_OBRIGATORIA`).

401Token ausente ou inválido (`CREDENCIAL_INVALIDA`).

404Empréstimo inexistente (`EMPRESTIMO_NAO_ENCONTRADO`).

422Regra de negócio impede a operação (`ERRO_NEGOCIO`). A mensagem traz o motivo (inclusive de sistemas a montante, como o BaaS Socinal).

502Integração externa indisponível (`DATAPREV_INDISPONIVEL`).

Request

curl -X POST 'http://localhost:3101/v1/emprestimos/:id/desembolso' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Idempotency-Key: 3f1c8a90-0000-4000-8000-000000000000' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response

{
  "id": "24f70ed1-76f3-4604-b341-f2bef2b34d05",
  "parceiro_id": "3f67b7e7-5de9-4a76-b108-d3469b8c6292",
  "numero": "A7565141-000",
  "status": "averbada",
  "cpf_trabalhador": "93871045675",
  "nome_trabalhador": "João da Silva",
  "estado_civil": "solteiro",
  "cnpj_empregador": "12674953000114",
  "nome_empregador": "Alves Teixeira - EI",
  "matricula": "MAT-5646996721",
  "valor_liberado": "1000",
  "prazo": 10,
  "taxa_mensal": "0.0179",
  "parcela_valor": "112.07",
  "cet_anual": "0.2387",
  "iof": "17.86",
  "total_a_pagar": "1120.7",
  "saldo_devedor": "1120.7",
  "parcelas_pagas": 0,
  "chave_pix": "joao@example.com",
  "data_emissao": "2026-06-10T00:00:00.000Z",
  "data_primeira_parcela": "2026-08-28T00:00:00.000Z",
  "data_liberacao": "2026-06-10T00:00:00.000Z",
  "d4sign_uuid": "e9c02dc2-ab60-4e2f-a401-c263f443282d",
  "d4sign_status": "assinado",
  "criado_em": "2026-06-03T00:22:05.057Z",
  "atualizado_em": "2026-06-03T00:34:36.084Z",
  "proxima_acao": "desembolsar"
}