---
title: "Transferência via TED"
method: POST
path: "/fund-transfers"
tags: ["Operações via TED"]
---

# Transferência via TED

`POST /fund-transfers`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/fund-transfers`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Realize a transferência de valores via TED entre contas pertencentes ao Bankly e do Bankly para contas de outras instituições financeiras.</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> <span class="bkly-ref-scope-tag">scope: ted.cashout.create</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Transferência via TED](/docs/transferencia-via-ted)."
}
[/block]

## Headers

- `Idempotency-Key` string

## Parameters

- `#/paths/~1fund-transfers/get/parameters/1` (unresolved $ref)
- `#/paths/~1fund-transfers/get/parameters/0` (unresolved $ref)
- `#/paths/~1fund-transfers/get/parameters/2` (unresolved $ref)

## Request body

- object
  - `amount` integer, required: Valor a ser transferido.
  - `sender` Sender, required
    - `document` string, required: Número do documento.
    - `name` string, required: Nome do pagador.
    - `branch` string, required: Agência bancária.
    - `account` string, required: Número da conta.
  - `recipient` Recipient, required
    - `accountType` 'CHECKING' | 'SAVINGS': Tipo de conta. Caso este campo <b>não</b> seja enviado na requisição, será considerado o valor "CHECKING".
    - `document` string, required: Número do documento.
    - `bankCode` string, required: Código do banco.
    - `branch` string, required: Agência bancária.
    - `account` string, required: Número da conta.
    - `name` string, required: Nome do recebedor.
  - `description` string: Descrição da transferência.

## Response `202`

A transferência via TED foi criada com sucesso.

- object
  - `authenticationCode` string: Código de autenticação da transação realizada.

## Other responses

- `400` (unresolved $ref)
- `403` (unresolved $ref)
- `409` (unresolved $ref)
- `422` (unresolved $ref)
- `429`: A operação foi recusada, pois muitas solicitações foram feitas dentro de um determinado período ou o limite global de requisições concorrentes foi atingido.
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/ted.md) - [All operations](https://skmtc.dev/bankly/apis/ted/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/ted/revisions/8cb3300a780b?raw)