Crédito

A operação de crédito nasce a partir de uma simulação salva como rascunho e é efetivada por meio da confirmação. Ao confirmar, a operação deixa de ser um rascunho e entra na fila de análise de risco da Grafeno.

Pré-requisitos

Antes de confirmar a operação, é necessário:

1. Simular com save_as_draft=true. A simulação fica disponível na plataforma como rascunho (draft) e gera o credit_id da operação.
2. Cadastrar o tomador de crédito (devedor) e enviar seus documentos, obtendo o debtor_id.
3. Selecionar as minutas necessárias ao tipo de operação, obtendo seus identificadores no endpoint de minutas.

Transição de status

A confirmação altera o status da operação:

draft  →  admin_analysis

• draft: Operação em rascunho, resultante da simulação.
• admin_analysis: Operação submetida à análise de risco da Grafeno.

Endpoint

POST /laas/v2/credit/confirm

Parâmetros do corpo

Exemplo de requisição

curl --location 'https://apis.stg.grafeno.be/laas/v2/credit/confirm' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer {access_token}' \
     --data '{
       "credit_id": "{uuid_da_operacao}",
       "debtor_id": "{uuid_do_devedor}",
       "minutes": ["{uuid_minuta_1}", "{uuid_minuta_2}"]
     }'

Tratamento de erros

A validação da confirmação é assíncrona: o retorno de erro não vem no corpo da resposta da requisição, e sim via webhook.

Alguns erros comuns retornados por webhook:

• Minuta inválida: Alguma das minutas informadas não é válida para o tipo de operação (ou não está aprovada).
• Devedor sem documentos cadastrados: O tomador de crédito informado não possui os documentos obrigatórios enviados.

⚠️

Importante

Configure um endpoint de webhook para receber tanto o resultado de sucesso quanto os erros da confirmação.