---
title: "Submeter lote de pagamento"
method: POST
path: "/{companyId}/banking/payroll/payments"
tags: ["Pagamentos"]
---

# Submeter lote de pagamento

`POST /{companyId}/banking/payroll/payments`

Submete um lote de pagamentos para processamento assíncrono. Retorna `202 Accepted` com o identificador do lote (`paymentId` e `requestId`).

O header `X-Idempotency-Key` (UUID v4) é obrigatório para evitar processamento duplicado em caso de retentativa.

## Path parameters

- `companyId` string, required

## Headers

- `X-Idempotency-Key` string, uuid, required

## Request body

- SubmitPaymentBatchRequest
  - `description` string, nullable
  - `scheduledDate` string, date-time
  - `paymentType` 2 | 5 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 17 | 18 | 19 | 20 | 21 | 22 | 24 — Tipo de operação de pagamento. Valores aceitos: - `2` = Salário (`PAG_SALARIO`) - `5` = PLR (Participação nos Lucros e Resultados) (`PAG_PLR`) - `9` = Férias (`PAG_FERIAS`) - `10` = Décimo Terceiro (`PAG_DEC_TERCEIRO`) - `11` = Rescisão (`PAG_RESCISAO`) - `12` = Prêmio / Bonificação (`PAG_PREMIO`) - `13` = Pagamento Genérico (Crédito em Conta) (`PAG_CREDITO_EM_CONTA`) - `14` = Distribuição de Dividendos (`PAG_DIST_DIVIDENDOS`) - `15` = Pagamento de Fornecedor (`PAG_FORNECEDOR`) - `17` = Adiantamento (`PAG_ADIANTAMENTO`) - `18` = Pró-labore (`PAG_PROLABORE`) - `19` = Bolsa Estágio (`PAG_BOLSA_ESTAGIO`) - `20` = Benefício (`PAG_BENEFICIO`) - `21` = Remuneração (`PAG_REMUNERACAO`) - `22` = Reembolso (`PAG_REEMBOLSO`) - `24` = Comissão (`PAG_COMISSAO`)
  - `companies` PaymentCompanyRequest[], nullable
    - `taxId` string, nullable
    - `debitParty` PaymentDebitPartyRequest
      - `branchCode` string, nullable — Agência da conta débito. Aceita com ou sem zeros à esquerda (ex.: "50" e "0050" são equivalentes, o valor é normalizado internamente).
      - `number` string, nullable
    - `items` PaymentItemRequest[], nullable
      - `taxId` string, nullable
      - `bankCode` string, nullable
      - `branchCode` string, nullable
      - `accountNumber` string, nullable
      - `netAmount` number, double
      - `reference` string, nullable

## Response `202`

Accepted

- SubmitPaymentBatchResponse
  - `requestId` string, nullable
  - `paymentId` integer
  - `status` string, nullable
  - `submittedAt` string, date-time
  - `totalEmployees` integer
  - `totalAmount` number, double
  - `scheduledDate` string, date-time

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/btgpactual/apis/folha-de-pagamentos.md) · [All operations](https://skmtc.net/btgpactual/apis/folha-de-pagamentos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/btgpactual/folha-de-pagamentos/revisions/2a24d3da114c/schema)