---
title: "Realizar TED"
method: POST
path: "/v5/transactions/banktransfer"
---

# Realizar TED

`POST /v5/transactions/banktransfer`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev`
- URL: `https://sandbox.openfinance.celcoin.dev/v5/transactions/banktransfer`
- Auth: OAuth 2

Essa API possibilita que seja realizada uma transferência da sua conta bolsão Celcoin para outra instituição financeira.Para saber como implementar essa API criamos o [artigo](https://developers.celcoin.com.br/docs/sobre-as-transfer%C3%AAncias).Mapeamos também os possíveis erros que essa API pode retornar nesse [artigo](https://developers.celcoin.com.br/docs/tabela-de-erros). Recomendamos que os campos sejam preenchidos conforme suas descriçōes.

## Request body

- object
  - `document` string, required: Cadastro pessoa física ou jurídica do favorecido(CPF ou CNPJ). Este campo deve ser preenchido sem nenhum caracter especial e precisa ter 11 digitos.
  - `externalTerminal` string: Terminal de identificação externa do sistema do cliente, Ex: CPF.
  - `externalNSU` integer: Identificador da transação do sistema cliente.
  - `accountCode` string: Número da conta.
  - `digitCode` string: Digíto da conta.
  - `branchCode` string: Número da agência.
  - `institutionCode` integer: Código do banco. Deve ter 3 digitos
  - `name` string: Nome do favorecido.
  - `value` number, double, required: Valor da transação.
  - `bankAccountType` string: Identificação da conta (Enviar "CC" para conta corrente ou "CP" para conta poupança).
  - `institutionIspb` string, required: Ispb identificador da instituição participante do Pix. Veja a relação desses códigos [aqui](https://www.bcb.gov.br/pom/spb/estatistica/port/ASTR003.pdf).

## Response `200`

200

- object
  - `authenticationAPI` object
    - `bloco1` string
    - `bloco2` string
    - `blocoCompleto` string
  - `receipt` object
    - `receiptData` string
    - `receiptformatted` string
  - `destinationAccountData` object
    - `agency` integer
    - `institutionCode` integer
    - `account` integer
    - `accountVerifierDigit` string
    - `document` string
    - `institutionName` string
    - `fullName` string
    - `bankAccountType` integer
    - `documentType` string
    - `value` integer
  - `createDate` string
  - `dateNextLiquidation` string
  - `nextSettle` boolean
  - `transactionId` integer
  - `endToEnd` string
  - `urlreceipt` string
  - `errorCode` string
  - `message` string
  - `status` integer

## Other responses

- `400`: 400
- `401`: 401
- `500`: 500

---

[API](https://skmtc.dev/celcoin/apis/transfer-ncias.md) - [All operations](https://skmtc.dev/celcoin/apis/transfer-ncias/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/transfer-ncias/revisions/800929a1928e?raw)