---
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`

## Request

- Base URL: `https://api.sandbox.paytime.com.br`
- URL: `https://api.sandbox.paytime.com.br/v1/marketplace/banking/transfers/ted`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/paytime/apis/api-p-blica/docs/v1/marketplace/banking/transfers/ted/post.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/paytime/apis/api-p-blica.md) - [All operations](https://skmtc.dev/paytime/apis/api-p-blica/llms.txt) - [OpenAPI document](https://skmtc.dev/paytime/apis/api-p-blica/revisions/5c818991d183?raw)