Webhooks de gestão de risco

O risk_amount corresponde ao saldo devedor das operações ainda não cedidas — ou seja, a exposição em aberto da carteira que permanece sob risco e que consome o limite (limit_amount) disponível para novos desembolsos. Conforme as operações são cedidas ou quitadas, elas deixam de compor o risk_amount e liberam limite para novos desembolsos.

Regra de desembolso

Se risk_amount + issue_amount > limit_amount, a operação não será desembolsada.

Habilitação

Entre em contato com o time da QI Tech para configurarmos o envio!

Webhook de atualização de risco

Enviado periodicamente, a cada hora, com a atualização do valor de risco acumulado do cliente.

Response Body

{
    "key": "b3a7e2c4-9d1f-4e8a-a456-2c3d4e5f6a7b",
    "data": {
        "risk_amount": 1500000,
        "limit_amount": 9000000,
        "reconciled_at": "2025-09-15T20:24:41"
    },
    "status": "completed",
    "webhook_type": "risk_management.risk_updated",
    "event_datetime": "2025-09-15T20:24:41Z"
}

Webhook de atualização de limite

Enviado quando o limite de emissão de dívidas do cliente é atualizado.

Response Body

{
    "key": "c4b8f3d5-0e2a-5f9b-b567-3d4e5f6a7b8c",
    "data": {
        "risk_amount": 0,
        "limit_amount": 9000000,
        "reconciled_at": "2025-09-15T18:03:54"
    },
    "status": "completed",
    "webhook_type": "risk_management.limit_updated",
    "event_datetime": "2025-09-15T18:03:54Z"
}

Definições

Objeto callback

Campo	Tipo	Descrição	Obrigatório
event_datetime	string	Data e hora do evento no formato ISO 8601 UTC	Sim
key	string	Chave única do evento	Sim
status	string	Status do evento	Sim
webhook_type	string	Tipo do webhook (risk_management.risk_updated ou risk_management.limit_updated)	Sim
data	object	Dados específicos do evento de gestão de risco	Sim

Objeto data

Campo	Tipo	Descrição	Obrigatório
risk_amount	number	Saldo devedor das operações ainda não cedidas — exposição em aberto da carteira que consome o limite disponível	Sim
limit_amount	number	Limite total disponível para emissão de novas dívidas	Sim
reconciled_at	string	Data e hora da última reconciliação no formato ISO 8601	Sim