---
title: "Transferência para Terceiros"
method: POST
path: "/transfer_requests"
---

# Transferência para Terceiros

`POST /transfer_requests`

Realize uma transferência para terceiros via TED ou PIX

## Headers

- `Request-Time` string, date-time, required
- `Signature` string, required

## Request body

- object
  - `scheduled_date` string, date — Data para **agendar** o PIX (AAAA-MM-DD)
  - `transfer_type` string, required — Tipo de transferência, "ted", "pix" ou "institucional".
  - `amount_cents` integer, required — Valor em centavos. Valor mínimo 2 centavos
  - `description` string — Descrição da transferência que irá aparecer no comprovante
  - `check_payer` string — Insira o documento (CPF ou CNPJ) do destinatário para validar se é o mesmo identificado através da chave PIX utilizada na transferência. Caso o documento enviado neste parâmetro seja diferente do cadastrado na chave PIX, a chamada retornará um erro.
  - `end_to_end_id` string — ID único do BACEN para rastreamento da transação Pix
  - `conciliation_id` string — ID opcional para rastreamento interno da transação. <br> **Limite de 35 caracteres/Não aceita caractere especial.**
  - `qrcode_type` string — Tipo do QR Code
  - `external_reference` string — Referência ou identificador externo da transferência. Não aparece no comprovante, apenas no retorno da requisição e no painel Alia.
  - `receiver` object — Dados do destinatário da transferência. Utilize "name" limitação de 140 caracteres e "cpf_cnpj" quando a transferência for TED ou PIX para conta bancária.
    - `name` string — Nome do recebedor da transferência. Obrigatório se a transferência for TED ou PIX para conta bancária.
    - `cpf_cnpj` string — CPF ou CNPJ do recebedor da transferência. Obrigatório se a transferência for TED ou PIX para conta bancária ou transfer_type = institucional. Agora é aceito o campo alfanumérico apenas para CNPJ.
    - `bank` object — Dados bancários do destinatário da transferência
      - `ispb` string — Número 'ispb', Identificador de Sistema de Pagamentos Brasileiro do banco que receberá a transferência. Ex: 60701190 caso seja Itaú. *Campo obrigatório caso a transferência seja TED ou PIX para conta bancária ou transfer_type = institucional*
      - `branch` string — Agência. Não precisa informar dígito. Obrigatório se transfer_type = institucional. Opcional se tipo da conta seja conta de pagamento.
      - `account` string — Número da conta + dígito da conta (se houver).* Não é necessário traço para separar o dígito. Campo obrigatório caso a transferência seja TED ou PIX para conta bancária.*
      - `account_type` string — Tipo de Conta: checking_account (Conta Corrente), salary_account (Conta Salário), savings_account (Poupança), payment_account (Conta de Pagamento). *Campo obrigatório caso a transferência seja TED ou PIX para conta corrente.*
      - `bank_branch_digit` string — Caso sua agência possua um 5° digito, é necessário informar nesse parâmetro.
    - `pix` object — Dados PIX do destinatário da transferência
      - `type` string — Tipo de chave PIX utilizada, *ex: cpf, cnpj, email, phone, evp (chave aleatória)*
      - `key` string — Chave à ser utilizada para transferência, *ex: teste@teste.com, +5511999999999, etc*
  - `hist` string — Histórico da Transação. Obrigatório se transfer_type = institucional.
  - `cit` string — Código Identificador de Transferência. Obrigatório se transfer_type = institucional.
  - `reason_code` string — Código da Finalidade da Transferência. Opcional — Se transfer_type = institucional.

## Response `202`

202

- object
  - `transfer_request_id` string
  - `created_at` string
  - `amount_cents` integer
  - `transfer_type` string
  - `end_to_end_id` string
  - `external_reference` string
  - `receipt_url` string
  - `status` string

## Other responses

- `400` — 400
- `422` — 422

---

[API](https://skmtc.net/iugu/apis/tokens-de-api.md) · [All operations](https://skmtc.net/iugu/apis/tokens-de-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iugu/tokens-de-api/versions/4590fc729d1e/schema)