---
title: "Criar transferência TED"
method: POST
path: "/v1/marketplace/banking/transfers/ted"
tags: ["Transferências"]
---

# Criar transferência TED

`POST /v1/marketplace/banking/transfers/ted`

## Headers

- `mTLS` string, required
- `integration-key` string, required
- `x-token` string, required

## Request body

- CreateTransferTedDto
  - `first_name` string, required — Primeiro nome do recebedor.
  - `last_name` string, required — Sobrenome do recebedor.
  - `document` string, required — Documento do recebedor.
  - `phone_number` string, required — Número de telefone do recebedor.
  - `email` string, required — E-mail do recebedor.
  - `bank_account` BankAccountDto, required
    - `account_check_digit` string, required — Dígito verificador da conta.
    - `account_number` string, required — Número da conta bancária.
    - `bank_code` string, required — Código de três dígitos do banco.
    - `routing_number` string, required — Número da agência bancária (sem dígito).
    - `routing_check_digit` string — Dígito verificador da agência (se aplicável).
    - `type` 'CHECKING' | 'SAVINGS', required — Tipo de conta bancária.
  - `recipient` RecipientDto, required
    - `amount` number, required — Valor da transferência em centavos.
    - `expected_at` string — Data esperada para conclusão da transferência.

## Response `200`

- TransferResponse
  - `_id` string, required — ID da transferência.
  - `type` 'TED' | 'P2P' | 'PIX', required — Tipo da transferência.
  - `status` 'CREATED' | 'PENDING' | 'PAID' | 'FAILED' | 'REFUNDED' | 'CANCELED' | 'PROCESSING', required — Status atual da transferência.
  - `amount` number, required — Valor transferido em centavos.
  - `original_amount` number — Valor original da transferência em centavos.
  - `establishment_id` string, required — ID do estabelecimento.
  - `gateway_key` string — Código do gateway.
  - `gateway_authorization` string, required — Código de autorização do gateway.
  - `expected_at` string, date-time, required — Data prevista para conclusão da transferência.
  - `recipient` TransferAccount, required
    - `establishment` TransferEntity, required
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `marketplace` TransferEntity, required
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `representative` TransferEntity
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `document` string, required — Documento do titular (CPF/CNPJ).
    - `bank_code` string — Código do banco.
    - `bank_ispb` string — ISPB do banco.
    - `bank_name` string — Nome do banco.
    - `routing_number` string — Número da agência bancária.
    - `routing_check_digit` string — Dígito verificador da agência.
    - `account_number` string, required — Número da conta bancária.
    - `account_check_digit` string, required — Dígito verificador da conta.
    - `type` 'SAVING' | 'CHECKING' | 'PAYMENT', required — Tipo da conta.
    - `pix_key` string — Chave pix de origem ou destino.
  - `payer` TransferAccount, required
    - `establishment` TransferEntity, required
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `marketplace` TransferEntity, required
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `representative` TransferEntity
      - `id` number, required
      - `first_name` string, required — Nome / Razão Social.
      - `last_name` string, required — Sobrenome / Nome Fantasia.
      - `document` string, required — CPF / CNPJ.
    - `document` string, required — Documento do titular (CPF/CNPJ).
    - `bank_code` string — Código do banco.
    - `bank_ispb` string — ISPB do banco.
    - `bank_name` string — Nome do banco.
    - `routing_number` string — Número da agência bancária.
    - `routing_check_digit` string — Dígito verificador da agência.
    - `account_number` string, required — Número da conta bancária.
    - `account_check_digit` string, required — Dígito verificador da conta.
    - `type` 'SAVING' | 'CHECKING' | 'PAYMENT', required — Tipo da conta.
    - `pix_key` string — Chave pix de origem ou destino.
  - `history` TransferHistory[], required — Histórico de status da transferência.
    - `status` 'CREATED' | 'PENDING' | 'PAID' | 'FAILED' | 'REFUNDED' | 'CANCELED' | 'PROCESSING', required — Status histórico da transferência.
    - `created_at` string, date-time, required — Data do registro do histórico.
    - `_id` string, required
  - `method` 'IN' | 'OUT', required — Direção da transferência (entrada ou saída).
  - `pixKey` string — Chave Pix utilizada (caso aplicável).
  - `end_to_end` string — Identificador único de cada transação.
  - `description` string — Descrição da transferência.
  - `reprocessed` boolean, required — Indica se a transferência foi reprocessada.
  - `created_at` string, date-time, required — Data de criação da transferência.
  - `updated_at` string, date-time, required — Data da última atualização da transferência.
  - `fees` number — Valor total de taxas da transferência.
  - `user` TransferUser
    - `id` number, required — Id do usuário.
    - `first_name` string, required — Primeiro nome.
    - `last_name` string — Sobrenome.
    - `profile_id` number, required — Id do perfil.

---

[API](https://skmtc.net/paytime/apis/api-p-blica.md) · [All operations](https://skmtc.net/paytime/apis/api-p-blica/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paytime/api-p-blica/revisions/5c818991d183/schema)