Execute PIX transfer by bank account (sync)
Sends a PIX transfer using the recipient’s bank account details (ISPB, branch, account number)
instead of a PIX key. Same behavior as POST /pix/out but without DICT key lookup.
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).
Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).
Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.
Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.
Request
Identificador do banco destino. Aceita 2 formatos no mesmo campo:
- COMPE (3 dígitos, ex.:
"341"Itaú,"237"Bradesco) - ISPB (8 dígitos, ex.:
"60701190"Itaú,"60746948"Bradesco)
A API normaliza (digits-only) e detecta o formato pelo
tamanho, roteando para o campo correto na chamada ao
parceiro. Aceita também "0341" (COMPE com leading zero
legado) e máscaras com pontos/traços ("60.701.190").
Pode usar o apelido bankCode — semanticamente
equivalente. Envie um dos dois, não os dois.
Recipient CPF or CNPJ (digits only)
Apelido para bankIspb. Aceita COMPE (3 dígitos)
ou ISPB (8 dígitos) — mesma lógica de detecção.
Use um OU outro, não os dois.
Integrator-provided identifier for tracking
Response
Internal payment intent identifier (tracking/reconciliation).
Canonical status:
COMPLETED- settled (HTTP 200)FAILED- rejected (HTTP 422; seeerrorCode/errorReason)TIMEOUT- indeterminate; request reached the partner (HTTP 202; check the statement before retrying)PENDING/PENDING_APPROVAL/PROCESSING- not terminal yet (HTTP 202)
Business identifier (client-provided or auto-generated UUID).
BACEN end-to-end PIX identifier (present once settled).
Error code (present when FAILED).
Error reason (present when FAILED).
Completion timestamp (UTC).
Present on indeterminate (TIMEOUT) results.