Perform an temporary Pix transfer

Performs a Pix transfer consuming the volume of an approved temporary Pix limit on the account, without touching the standard Pix limit. The endpoint resolves the account's active temporary limit on its own — there is no need to inform the pix_request_key.

Request

ENDPOINT

/account/ACCOUNT_KEY/exceptional_pix_transfer

METHOD

POST

caution

Available from 06:00 to 20:00 (Brasília time). Outside this window the response is PXT000204, even if volume is still available.

Path Params

Field	Type	Description	Characters
account_key	uuidv4	Unique identification key of the source account, which must have an approved temporary Pix limit.	36

Request Body

{
  "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
  "pix_transfer_type": "manual",
  "transaction_amount": 300000.00,
  "target_account": {
    "account_branch": "0001",
    "account_digit": "3",
    "account_number": "12345678",
    "owner_document_number": "32402502000135",
    "owner_name": "Qi Tech",
    "account_type": "checking_account",
    "ispb": "32402502"
  },
  "pix_message": "Pagamento de folha"
}

Body Params

Field	Type	Description	Characters
pix_transfer_type *	enumerator	Type of Pix to be performed. On this endpoint it accepts only the value manual.	"manual"
transaction_amount *	number	Transfer amount. Added to the volume already transacted, it cannot exceed the approved total_amount.	—
target_account *	object	Destination account data. See Object target_account.	—
request_control_key	uuidv4	Idempotency key of the request, defined by the partner. See Idempotency.	36
pix_message	string	Message to be sent along with the Pix transfer.	140

info

Transfers by Pix key, static QR Code or dynamic QR Code are not supported on this endpoint. For those types, use Perform Pix Transaction, which consumes the standard Pix limit.

Object target_account

Field	Type	Description	Characters
account_branch *	string	Branch of the destination account.	4
account_digit *	string	Digit of the destination account.	1
account_number *	string	Number of the destination account.	20
owner_document_number *	string	CPF or CNPJ of the destination account owner, digits only.	11 or 14
owner_name *	string	Name of the destination account owner.	100
account_type *	enumerator	Type of the destination account.	—
ispb *	string	ISPB of the destination account's institution.	8

Idempotency

The request_control_key is the idempotency key of the request.

Reuse is rejected, not replayed

When you resend a request_control_key already used, the request is refused — the original transfer is not returned nor re-executed, and no temporary Pix volume is consumed. Use a new key on each transfer.

Response

The response code depends on the execution mode configured for the requester, exactly as on the ordinary Pix transfer:

HTTP Code	pix_transfer_status	Meaning
201	sent	Transfer sent synchronously
202	pending	Transfer accepted and being processed asynchronously
202	pending_2fa_approval	Transfer awaiting two-factor authentication approval

Response Body: 201 Created

{
  "request_control_key": "b6804f32-101e-4702-8fbc-c2dbc4c2caec",
  "pix_transfer_key": "4f1c8b7a-2d3e-4f5a-9b8c-7d6e5f4a3b2c",
  "transaction_key": "8a7b6c5d-4e3f-2a1b-9c8d-7e6f5a4b3c2d",
  "end_to_end_id": "E32402502202608141530abcdefghijk",
  "pix_transfer_status": "sent",
  "created_at": "2026-08-14 15:30:00"
}

Response Body Params

Field	Type	Description
request_control_key	uuidv4	Idempotency key informed in the request.
pix_transfer_key	uuidv4	Unique identification key of the Pix transfer in the QI system.
transaction_key	uuidv4	Unique identification key of the transaction.
end_to_end_id	string	Idempotency key of the Pix transaction within the SPI.
pix_transfer_status	enumerator	Status of the transfer.
created_at	string	Date and time the transfer was created.

info

The temporary Pix limit volume is reserved at the moment of this call, before execution, and is released if the transfer is rejected. In the asynchronous and 2FA modes the reservation crosses the processing — the volume stays reserved while the transfer is pending.

Errors

The errors specific to temporary Pix are in Error Table for Temporary Pix. This operation may return PXT000201, PXT000203 and PXT000204.

Beyond those, all the errors of the ordinary Pix transfer apply — see Perform Pix Transaction.