Creating Reversal Request

---

Request

ENDPOINT

/transaction_reversal/fund_class/FUND_CLASS_KEY/transaction_reversal

METHOD

POST

Response

STATUS

201

Response Body

{
    "amount": 125.25,
    "description": "Estorno - transferência indevida",
    "reversal_type": "pix",
    "reference_date": "2025-01-01",
    "source_account": {
        "owner": {
            "name": "Nome do Fundo",
            "document_number": "123.805.491-24"
        },
        "account_digit": "8",
        "account_branch": "0001",
        "account_number": "1234567",
        "financial_institution": {
            "ispb": "32402502",
            "code": "329",
            "name": "QI Sociedade de Crédito Direto"
        },
    },
    "transaction_key": "4208d7d1-9077-4d00-aa4a-a4368b954867"
}

Path Params

Field	Type	Description
fund_class_key	string	Unique identifier key for the fund at QI CTVM

Body Params

Field	Type	Description
amount*	float	Amount to be reversed
description*	string	Description of the reversal performed
reversal_type*	string	Type of reversal to be sent
reference_date*	string	Reference date for the reversal processing
source_account_key	int	Unique identifier key of the reversal source account
source_account	Account	Source account object of the reversal
transaction_key*	string	Unique identifier key of the transfer to reverse in the cash system
reference_key	string	Reference key of the transfer to reverse at the source bank
conciliation_field	string	Field for reconciliation across multiple expectations
end_to_end_id	string	Identifier of the Pix to reverse
external_key	string	Unique key of the transaction to reverse at the source bank
bank_slip_settlement_group_key	string	Unique key of the bankslip settlement to reverse at the source bank

Attention

The source_account_key and source_account fields identify the source of the amount to be reversed. 1 field of each must be sent; if multiple are sent, a 400 error is returned.

Account

Field	Type	Description	Characters
account_number	string	Account number	Up to 50
account_digit	string	Account digit	1
account_branch	string	Account branch	Up to 4
financial_institution	Financial Institution	Financial institution object	-
owner	Owner	Owner object	-

Financial institution

Field	Type	Description	Characters
ispb	string	Brazilian Payment System Identifier	8
code	string	Financial institution code	3
name	string	Financial institution name	Up to 255

Owner

Field	Type	Description	Characters
name	string	Owner name	up to 255
document_number	string	Owner document	14 or 18