---
title: "PIX/TED Out"
method: POST
path: "/transfer_requests"
---

# PIX/TED Out

`POST /transfer_requests`

## Request

- Base URL: `https://api.iugu.com/v1`
- URL: `https://api.iugu.com/v1/transfer_requests`
- Auth: API key in query parameter `api_token`

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. Agora é aceito o campo alfanumérico apenas para CNPJ.
  - `qrcode_type` string: Tipo do QR Code
  - `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.**
  - `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.<br>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.dev/iugu/apis/baas.md) - [All operations](https://skmtc.dev/iugu/apis/baas/llms.txt) - [OpenAPI document](https://skmtc.dev/iugu/apis/baas/revisions/36bf4590d03a?raw)