---
updatedAt: 2026-08-20T20:17:04.000Z
agentTools:
  projectIndex: https://dev.iugu.com/llms.txt
---

# PIX/TED Out

Realize uma transferência para terceiros via TED ou PIX

<Callout icon="❗" theme="error">
  ### Atenção

  O hash de **PIX** só funciona quando o **transfer_type** for definido como **PIX**, mas o array de **BANK** funciona tanto para **transfer_type** definido como **PIX** ou como **TED**. Isso porque é possível fazer **PIX** para uma conta corrente.
</Callout>

<Callout icon="⚠️" theme="warn">
  ### Importante

  Aguarde no mínimo **5 segundos** entre uma solicitação de transferência para terceiros e a próxima. Enviando antes desse intervalo, a API retorna: `"Já existe uma transferência em processamento nesta conta. Espere a conclusão e tente novamente."`
</Callout>

Para mais detalhes, exemplos de status e possíveis mensagens de erro, acesse nossa [Documentação Técnica](https://dev.iugu.com/docs/transfer%C3%AAncia-para-terceiros).

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "baas",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.iugu.com/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "api_token",
        "in": "query"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/transfer_requests": {
      "post": {
        "summary": "PIX/TED Out",
        "description": "Realize uma transferência para terceiros via TED ou PIX",
        "operationId": "baas-pix-ted-out",
        "parameters": [
          {
            "name": "Request-Time",
            "in": "header",
            "description": "Timestamp do momento que enviar a requisição de assinatura digital (RSA)",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "Signature",
            "in": "header",
            "description": "Assinatura digital validada",
            "required": true,
            "schema": {
              "type": "string",
              "default": "signature="
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "transfer_type",
                  "amount_cents"
                ],
                "properties": {
                  "scheduled_date": {
                    "type": "string",
                    "description": "Data para **agendar** o PIX (AAAA-MM-DD)",
                    "format": "date"
                  },
                  "transfer_type": {
                    "type": "string",
                    "description": "Tipo de transferência, \"ted\", \"pix\" ou \"institucional\"."
                  },
                  "amount_cents": {
                    "type": "integer",
                    "description": "Valor em centavos. Valor mínimo 2 centavos",
                    "format": "int32"
                  },
                  "description": {
                    "type": "string",
                    "description": "Descrição da transferência que irá aparecer no comprovante"
                  },
                  "check_payer": {
                    "type": "string",
                    "description": "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": {
                    "type": "string",
                    "description": "Tipo do QR Code"
                  },
                  "end_to_end_id": {
                    "type": "string",
                    "description": "ID único do BACEN para rastreamento da transação Pix"
                  },
                  "conciliation_id": {
                    "type": "string",
                    "description": "ID opcional para rastreamento interno da transação. <br> **Limite de 35 caracteres/Não aceita caractere especial.**"
                  },
                  "external_reference": {
                    "type": "string",
                    "description": "Referência ou identificador externo da transferência. Não aparece no comprovante, apenas no retorno da requisição e no painel Alia."
                  },
                  "receiver": {
                    "type": "object",
                    "description": "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.",
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "Nome do recebedor da transferência. Obrigatório se a transferência for TED ou PIX para conta bancária."
                      },
                      "cpf_cnpj": {
                        "type": "string",
                        "description": "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": {
                        "type": "object",
                        "description": "Dados bancários do destinatário da transferência",
                        "properties": {
                          "ispb": {
                            "type": "string",
                            "description": "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": {
                            "type": "string",
                            "description": "Agência. Não precisa informar dígito. Obrigatório se transfer_type = institucional. Opcional se tipo da conta seja conta de pagamento."
                          },
                          "account": {
                            "type": "string",
                            "description": "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": {
                            "type": "string",
                            "description": "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": {
                            "type": "string",
                            "description": "Caso sua agência possua um 5° digito, é necessário informar nesse parâmetro."
                          }
                        }
                      },
                      "pix": {
                        "type": "object",
                        "description": "Dados PIX do destinatário da transferência",
                        "properties": {
                          "type": {
                            "type": "string",
                            "description": "Tipo de chave PIX utilizada, ex: cpf, cnpj, email, phone, evp (chave aleatória)"
                          },
                          "key": {
                            "type": "string",
                            "description": "Chave à ser utilizada para transferência, ex: teste@teste.com, +5511999999999, etc"
                          }
                        }
                      }
                    }
                  },
                  "hist": {
                    "type": "string",
                    "description": "Histórico da Transação. Obrigatório se transfer_type = institucional."
                  },
                  "cit": {
                    "type": "string",
                    "description": "Código Identificador de Transferência. Obrigatório se transfer_type = institucional."
                  },
                  "reason_code": {
                    "type": "string",
                    "description": "Código da Finalidade da Transferência. Opcional — Se transfer_type = institucional."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "202",
            "content": {
              "application/json": {
                "examples": {
                  "Sucesso (PIX)": {
                    "value": "{\n  \"transfer_request_id\": \"0321A2977E7D4C199AF26AE5C74220EA\",\n  \"created_at\": \"2023-02-15T21:50:45-03:00\",\n  \"amount_cents\": 2,\n  \"transfer_type\": \"pix\",\n  \"end_to_end_id\": \"E1511197520230216005028cd18c6d3d\",\n  \"external_reference\": \"T002\",\n  \"receipt_url\": \"https://comprovantes.iugu.com/0321a297-7e7d-4c19-9af2-6ae5c74220ea-e3049a\",\n  \"status\": \"done\"\n}"
                  },
                  "Sucesso (TED)": {
                    "value": ""
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "transfer_request_id": {
                      "type": "string",
                      "example": "0321A2977E7D4C199AF26AE5C74220EA"
                    },
                    "created_at": {
                      "type": "string",
                      "example": "2023-02-15T21:50:45-03:00"
                    },
                    "amount_cents": {
                      "type": "integer",
                      "example": 2,
                      "default": 0
                    },
                    "transfer_type": {
                      "type": "string",
                      "example": "pix"
                    },
                    "end_to_end_id": {
                      "type": "string",
                      "example": "E1511197520230216005028cd18c6d3d"
                    },
                    "external_reference": {
                      "type": "string",
                      "example": "T002"
                    },
                    "receipt_url": {
                      "type": "string",
                      "example": "https://comprovantes.iugu.com/0321a297-7e7d-4c19-9af2-6ae5c74220ea-e3049a"
                    },
                    "status": {
                      "type": "string",
                      "example": "done"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "#Campo name dentro do objeto receiver de conter no máximo 140 caracteres#"
                  }
                }
              }
            }
          },
          "422": {
            "description": "422",
            "content": {
              "text/plain": {
                "examples": {
                  "Result": {
                    "value": "Documento do recebedor não condiz com o informado\nPayer document number don't match with the one provided"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```