Webhook de pagamento do sinistro

A QI Tech envia este webhook ao originador a cada pagamento da seguradora registrado num sinistro aceito. Ele traz o pagamento e o sinistro como ficou depois dele. O pagamento que atinge o valor aprovado liquida o sinistro: depois deste webhook vem um webhook de status com o status settled e o motivo fully_paid.

WEBHOOK_TYPE

insurance_premium.claim_transaction

A URL que recebe o webhook é a mesma dos demais webhooks do seguro. Veja Configurando webhooks.

Corpo do webhook

Campo	Tipo	Obrigatório	Descrição	Tamanho
key	uuid	Sim	Chave do pagamento. Igual a data.claim_transaction_key.	36
status	string	Sim	Sempre received.	—
webhook_type	string	Sim	Sempre insurance_premium.claim_transaction.	—
event_datetime	string	Sim	Data e hora do registro, em UTC, no formato AAAA-MM-DDTHH:MM:SSZ.	20
data	object	Sim	O pagamento e o sinistro. Veja a tabela abaixo.	—

Atributos de data

Campo	Tipo	Obrigatório	Descrição	Tamanho
claim_transaction_key	uuid	Sim	Chave do pagamento.	36
amount	number	Sim	Valor do pagamento, em reais.	—
payment_date	string	Sim	Data do pagamento pela seguradora, no formato AAAA-MM-DD.	10
external_transaction_key	string	Não	Referência do pagamento atribuída pela seguradora.	—
credit_operation_key	uuid	Sim	Chave da dívida (CCB) à qual o seguro está atrelado.	36
claim	object	Sim	O sinistro depois deste pagamento, com os mesmos campos de data do webhook de status, exceto credit_operation_key.	—

Exemplo — primeiro pagamento

{
    "key": "2b3f2c1e-8b7a-4d0e-9a51-0f6c4b1d7e21",
    "status": "received",
    "webhook_type": "insurance_premium.claim_transaction",
    "event_datetime": "2026-11-03T12:45:08Z",
    "data": {
        "claim_transaction_key": "2b3f2c1e-8b7a-4d0e-9a51-0f6c4b1d7e21",
        "amount": 454.77,
        "payment_date": "2026-11-03",
        "external_transaction_key": "pagamento-0001",
        "credit_operation_key": "5ae2c008-44c1-4435-bbfa-094a4b11d962",
        "claim": {
            "claim_key": "fb88557a-e967-4012-b669-5e1bc2154534",
            "status": "accepted",
            "insurance_premium_key": "0d3b8f62-1a4e-4c7b-9f05-6e2d9a7c4b18",
            "coverage_type": "unemployment",
            "external_key": "sinistro-0001",
            "claim_data": {
                "approved_amount": 909.54,
                "approved_installment_quantity": 2
            },
            "paid_amount": 454.77,
            "transactions": [
                {
                    "claim_transaction_key": "2b3f2c1e-8b7a-4d0e-9a51-0f6c4b1d7e21",
                    "amount": 454.77,
                    "payment_date": "2026-11-03",
                    "external_transaction_key": "pagamento-0001"
                }
            ]
        }
    }
}

Erros

Este webhook não devolve erro ao originador. A sua URL deve responder com um status 2xx; o comportamento de entrega e o reenvio estão em Configurando webhooks.

Próximo passo

• Webhook de status do sinistro: os status do sinistro, da abertura à liquidação, e os motivos de recusa e encerramento.