Webhooks

Webhooks of the transaction_reversal.transaction_reversal_status_change type, sent to the fund's manager and to the associated assignor. To validate the signature, see Receiving Webhooks.

Only two events generate a webhook: the paid reversal and the reversal discarded after approval. A request rejected in the QI Tech validation moves to discarded without a webhook.

Reversal paid

STATUS

paid

Sent when the payment of the reversal is confirmed.

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"
}

Reversal discarded

STATUS

discarded

Sent when an already approved reversal is discarded before payment. The payload is the same as for the paid reversal, with status equal to discarded.

data fields

Field	Type	Description
transaction_reversal_key	string	Identifier of the reversal at QI Tech (UUID).
amount	number	Reversal amount, in reais.
status	string	paid or discarded.
description	string	Description provided in the request.
reference_date	string	Reference date of the reversal (YYYY-MM-DD).
fund_class_document_number	string	CNPJ of the fund.
fund_class_key	string	Key of the fund.
source_account	object	Source account of the reversal.
target_account	object	Target account of the reversal.
external_key	string	Identifier of the reversal payment. Only in the paid reversal, when available.
conciliation_field	string	Reconciliation field sent in the request. Present when available.
transaction_key	string	Reversed transaction. Present when available.
reference_key	string	Reference key. Present when available.
origin_key	string	The origin_key sent in the request. Present when available.