Webhooks

Webhooks do tipo transaction_reversal.transaction_reversal_status_change, enviados à gestora do fundo e ao cedente associado. Para validar a assinatura, veja Recebimento de Webhooks.

Só dois eventos geram webhook: o estorno pago e o estorno descartado depois de aprovado. Um pedido reprovado na validação da QI Tech passa a discarded sem webhook.

Estorno pago

STATUS

paid

Enviado quando o pagamento do estorno é confirmado.

Webhook Body

{
    "data":{
        "transaction_reversal_key": "b6da1a84-5bb3-4d71-9912-cbbcfe7189c1", 
        "amount": 123.45,
        "status": "paid", 
        "description": "Valor de liquidação indevido",
        "reference_date": "2025-03-23",
        "fund_class_document_number": "11.222.333/0001-81",
        "fund_class_key": "0619574f-2815-419d-8208-630b0dc30487",
        "source_account": {
            "account_digit": "7",
            "account_branch": "0001",
            "account_number": "0099999",
            "owner": {
                "name": "FUNDO DE INVESTIMENTO",
                "document_number": "11.222.333/0001-81"
            },
            "financial_institution": {
                "code": "329",
                "ispb": "32402502",
                "name": "QI Sociedade de Crédito Direto"
            }
        },
        "target_account":{
            "owner": {
                "name": "Nome fictício",
                "document_number": "969.698.790-03"
            },
            "account_digit": "0",
            "account_branch": "0001",
            "account_number": "1029490",
            "target_pix_key": "1232221",
            "financial_institution": {
                "code": "033",
                "ispb": "90400888",
                "name": "BCO SANTANDER (BRASIL) S.A."
            }
        },
        "external_key":"40054daa-c3c5-49cd-add7-858b576c5887"
    },
    "webhook_type":"transaction_reversal.transaction_reversal_status_change",
    "webhook_datetime":"2025-03-23T15:08:30Z"
}

Estorno descartado

STATUS

discarded

Enviado quando um estorno já aprovado é descartado antes do pagamento. O payload é o mesmo do estorno pago, com status igual a discarded.

Campos de data

Campo	Tipo	Descrição
transaction_reversal_key	string	Identificador do estorno na QI Tech (UUID).
amount	number	Valor do estorno, em reais.
status	string	paid ou discarded.
description	string	Descrição informada no pedido.
reference_date	string	Data de referência do estorno (YYYY-MM-DD).
fund_class_document_number	string	CNPJ do fundo.
fund_class_key	string	Chave do fundo.
source_account	object	Conta de origem do estorno.
target_account	object	Conta de destino do estorno.
external_key	string	Identificador do pagamento do estorno. Só no estorno pago, quando houver.
conciliation_field	string	Campo de conciliação enviado no pedido. Presente quando houver.
transaction_key	string	Transação estornada. Presente quando houver.
reference_key	string	Chave de referência. Presente quando houver.
origin_key	string	O origin_key enviado no pedido. Presente quando houver.