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

# Realizar TED

`POST /v5/transactions/banktransfer`

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.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/revisions/85dd6188a37b/schema)