Send TED (Brazilian interbank transfer)
Sends a TED (Transferência Eletrônica Disponível) to another bank in the SPB network.
Asynchronous by design. The POST only confirms receipt by the settlement bank
(status PROCESSING); the final terminal state arrives via webhooks ted.out.confirmed
or ted.out.failed (or via the GET status endpoint).
BACEN window: business days 06:30–17:00 (Brazilian time). TEDs sent within the window settle the same day (~30 minutes). Outside the window, the TED is scheduled for the next business day.
Defensive polling: the server polls the partner statement every 1 minute for up to 48 hours, ensuring convergence even if the partner webhook is delayed or lost.
Settlement bank for receiving TEDs: Compe code 681 / ISPB 50871921. See the TED guide for details.
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
Amount in BRL, from R$ 0.01 through R$ 14,999.99, max 2 decimals.
Destination bank Compe code — 3 digits (e.g. 001, 237, 341). TED does not
accept ISPB: an 8-digit value is rejected with 400 invalid_bank_code.
For PIX by bank account, ISPB is accepted (bankIspb).
Destination account number, digits only (no final check digit).
Recipient CPF (11) or CNPJ (14) digits, no punctuation.
Recipient legal/full name.
Optional free-form message (NF number, reference, etc.).
Integrator correlation key forwarded to the settlement bank and echoed
in TED webhooks (ted.out.*). Max 38 chars [A-Za-z0-9._-].
Distinct from the Idempotency-Key header (HTTP attempt identity).
Auto-generated hex UUID (32 chars) if omitted.
Response
Idempotent retry — returns the existing TED state.
Internal TED ID (format ted-{identifier}). Use to query status.
PROCESSING when the workflow started successfully; ACCEPTED when the workflow could not be started immediately (poll later).