---
title: "Criar lote"
method: POST
path: "/batch"
tags: ["Lotes"]
---

# Criar lote

`POST /batch`

## Request

- Base URL: `https://api.transfeera.com`
- URL: `https://api.transfeera.com/batch`
- Auth: HTTP bearer

## Headers

- `User-Agent` string

## Request body

- union
  - object
    - `name` string
    - `auto_close` boolean: Opção que indica se o lote será fechado de forma automática. Ao ser informada como `true`, o lote será fechado e processado assim que for criado.
    - `type` 'BOLETO', required
    - `billets` BilletReq[]
      - `value` number, float: O campo value é opcional e é usado apenas se você precisar configurar um valor diferente para o boleto, em casos onde o valor do boleto fica em aberto ou tem juros e multas. Caso contrário não passe esta propriedade.
      - `payment_date` string, required
      - `barcode` string, required
      - `description` string, required
      - `integration_id` string
  - object
    - `name` string
    - `auto_close` boolean: Opção que indica se o lote será fechado de forma automática. Ao ser informada como `true`, o lote será fechado e processado assim que for criado.
    - `type` 'TRANSFERENCIA'
    - `transfers` TransferReq[]
      - 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` integer

---

[API](https://skmtc.dev/transfeera/apis/pagamentos.md) - [All operations](https://skmtc.dev/transfeera/apis/pagamentos/llms.txt) - [OpenAPI document](https://skmtc.dev/transfeera/apis/pagamentos/revisions/9ae3c108bf52?raw)