---
title: "Criar transferência"
method: POST
path: "/batch/{id}/transfer"
tags: ["Transferências"]
---

# Criar transferência

`POST /batch/{id}/transfer`

## Path parameters

- `id` string, required

## Headers

- `User-Agent` string

## Request body

- union
  - object
    - `value` number, float, required — Valor da transferência
    - `integration_id` string — ID de integração
    - `idempotency_key` string — Chave de idempotência
    - `payment_date` string, date — Data para agendamento do pagamento (YYYY-MM-DD) - Prazo máximo de 30 dias
    - `pix_description` string — Comentário que será enviado no Pix
    - `destination_bank_account` object, required
      - `pix_key_type` 'EMAIL' | 'CPF' | 'CNPJ' | 'TELEFONE' | 'CHAVE_ALEATORIA', required
      - `pix_key` string, required
      - `email` string — E-mail para notificar o recebedor sobre a transferência Pix
    - `pix_key_validation` object
      - `cpf_cnpj` string — Documento para validar se o recebedor é o titular da chave Pix
    - `pix_end2end_id` string — End2end id da consulta de chaves Pix no DICT
    - `recurrence` RecurrenceReq
      - `interval` integer, required — Intervalo de tempo entre pagamentos
      - `interval_type` 'day' | 'month', required
      - `number_of_payments` integer — Número de pagamentos a serem realizados Caso seja `null`, a recorrência terá fim indeterminado
  - object
    - `value` number, float, required — Valor da transferência
    - `integration_id` string — ID de integração
    - `idempotency_key` string — Chave de idempotência
    - `payment_date` string, date — Data para agendamento do pagamento (YYYY-MM-DD) - Prazo máximo de 30 dias
    - `pix_description` string — Comentário que será enviado no Pix
    - `pix_key_validation` object
      - `cpf_cnpj` string — Documento para validar se o recebedor é o titular da chave Pix
    - `emv` string, required
    - `pix_end2end_id` string — End2end id da consulta de chaves Pix no DICT
  - object
    - `value` number, float, required — Valor da transferência
    - `integration_id` string — ID de integração
    - `idempotency_key` string — Chave de idempotência
    - `payment_date` string, date — Data para agendamento do pagamento (YYYY-MM-DD) - Prazo máximo de 30 dias
    - `pix_description` string — Comentário que será enviado no Pix
    - `destination_bank_account` object, required
      - `name` string — Nome do recebedor
      - `cpf_cnpj` string, required — Documento do recebedor
      - `bank_code` integer, required — Código do banco
      - `bank_ispb` string — ISPB do banco, obrigatório se o bank_code não for preenchido
      - `email` string — E-mail do recebedor
      - `agency` string, required — Agência da conta
      - `account` string, required — Número da conta
      - `account_digit` string, required — Dígito do número da conta
      - `account_type` 'CONTA_CORRENTE' | 'CONTA_POUPANCA' | 'CONTA_PAGAMENTO' | 'CONTA_FACIL' | 'ENTIDADES_PUBLICAS', required

## Response `200`

Successful response

- object
  - `id` string
  - `value` integer
  - `pix_description` string
  - `pix_end2end_id` string
  - `status` string
  - `emv` string
  - `authorization_code` string
  - `destination_bank_account_id` string
  - `batch_id` string
  - `integration_id` string
  - `idempotency_key` string

---

[API](https://skmtc.net/transfeera/apis/autentica-o.md) · [All operations](https://skmtc.net/transfeera/apis/autentica-o/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/transfeera/autentica-o/versions/cf24b926bbaa/schema)