Create internal transfer by document (CPF/CNPJ)
Creates an internal transfer where the destination is identified by the holder’s CPF or CNPJ. The system resolves the destination account in the banking ecosystem automatically.
Unlike the /by-bank-account endpoint (which only works for accounts registered in the API),
this endpoint can transfer to any account in the banking ecosystem that matches the given document.
Internal transfers are instant. Outbound amounts are checked against
the same daily remaining allowance as the mobile app (São Paulo
calendar day) and the per-transaction PIX cap; over-limit calls
return 422 limit_exceeded_daily or limit_exceeded_transaction.
Multiple accounts per document: when the destination document has more than one active
account, addressing by document is ambiguous and the request is rejected with
409 multiple_destination_accounts. Address the transfer with
/transfers/internal/by-bank-account (branch + account number) or
/transfers/internal (destinationAccountId) instead.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Headers
Client-generated idempotency token.
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.
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
Destination holder’s CPF (11 digits) or CNPJ (14 digits), numbers only.
Transfer amount in BRL. Max 2 decimal places (e.g., 500.00 for R$500,00).
Transfer description (visible to both parties).
Response
Recipient’s CPF/CNPJ.
Transferred amount in BRL. Max 2 decimal places (e.g., 500.00 for R$500,00).