[DEPRECATED] Large PIX transfer by bank account (BigPix)
[DEPRECATED] Large PIX transfer by bank account (BigPix)
DEPRECATED: the R$ 15,000 per-transaction limit has been removed.
POST /v1/accounts/{accountId}/pix/out/bank-account now accepts any
amount in a single transaction, so BigPix chunking is no longer necessary.
This endpoint remains functional for backward compatibility and returns
the Deprecation: true header. Migrate to POST /pix/out/bank-account.
The final removal date will be announced in the changelog in advance.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Headers
CPF of the human performing the operation. Required on cashout routes when the credential enforces a transaction PIN. On a company P2P profile contact, this CPF is the holder who signs; it is not taken from the body.
Transaction PIN of the operator in X-Acting-Document. Required on cashout routes when the credential enforces a PIN (428 pin_required).
Real IP of the end user, for integrator credentials calling on their behalf. This is the IP evaluated against cashoutSourceIps — without it the check would see your server’s IP. Ignored for delegated credentials, where the connection IP is already the right one.
Optional user-agent of the end user’s browser or app, for integrator credentials calling on their behalf. Feeds risk analysis only: an invalid or oversized value is dropped and the payment still proceeds. Ignored for delegated credentials.
Optional device fingerprint or identifier from the integrator’s own system. Risk analysis only; never required and never a reason to reject the payment. Ignored for delegated credentials.
Optional session id of the end user in the integrator’s system. Risk analysis only; never required and never a reason to reject the payment. Ignored for delegated credentials.
Optional latitude,longitude in decimal degrees. Out of range or malformed values are dropped. Risk analysis only. Ignored for delegated credentials.
Optional client-generated idempotency token (recommended for safe retries).
Request
Pelo menos um de bankIspb ou bankCode é obrigatório
(aceitam COMPE 3-dig OU ISPB 8-dig no mesmo campo — ver
descrição na rota /pix/out/bank-account síncrona). A
normalização é feita uma única vez no batch: todos os
chunks gerados herdam a rota resolvida.
Total amount to transfer (will be split into chunks)
COMPE (3 dígitos) ou ISPB (8 dígitos). Ver rota síncrona.
Apelido para bankIspb — aceita os mesmos formatos.
Response
Overall status:
FULL- All chunks succeeded (HTTP 200)PARTIAL- Some chunks failed (HTTP 207)FAILED- No chunks succeeded (HTTP 502)