Sign in

v1

latestOpenAPI 3.0.42026-07-24150552428.5 KB
Collection

Criar Cobranças em lote

API responsável por criar cobranças em lote. O contrato da API pode mudar dependendo do tipo da cobrança emitida. Verifique os campos de acordo com o tipo da cobrança

post/collections/batch

Request body

batchIdstring

Id do lote

numberstring required

Número da conta com dígito

branchCodestring required

Agência bancária

agreementstring

Número do convênio

Example request

{
  "batchId": "829c47f2-3b5c-4103-8d15-a55bd66ae905",
  "number": "003886850",
  "branchCode": "50",
  "agreement": "123456",
  "collections": [
    {
      "amount": 10.23,
      "type": "BANKSLIP",
      "dueDate": "2024-05-28",
      "overDueDate": "2025-04-20",
      "deliveryMediums": [
        "Email",
        "Push"
      ],
      "description": "Descrição do link de pagamento",
      "payer": {
        "name": "John Due",
        "email": "user@gmail.com",
        "personType": "J",
        "phoneNumber": "123123121231",
        "taxId": "37297902000141",
        "address": {
          "type": "COMERCIAL",
          "zipCode": "00000001",
          "country": "BR",
          "state": "SP",
          "city": "SAO PAULO",
          "street": "RUA SANDBOX",
          "number": "369",
          "neighborhood": "BAIRRO SANDBOX"
        },
        "deliveryMediums": [
          "Email",
          "Push"
        ]
      },
      "interest": {
        "startDate": "2023-10-02",
        "type": "FIXED_VALUE_PER_DAY",
        "value": 123
      },
      "fine": {
        "startDate": "2023-10-02",
        "type": "FIXED_VALUE",
        "value": 13
      },
      "discounts": [
        {
          "limitDate": "2023-10-10",
          "type": "FIXED_VALUE",
          "value": 13
        }
      ],
      "tags": [
        {
          "key": "name",
          "value": "value"
        }
      ],
      "detail": {
        "documentNumber": "PARCELA-123",
        "correlationId": "54865486214",
        "ourNumber": "54865486214",
        "badCredit": {
          "type": "APPLICABLE",
          "issueDate": "2025-04-01"
        },
        "installment": 1
      },
      "invoiceNumber": "54786752177624"
    }
  ]
}

Response

Cobrança criada com sucesso.

collectionIdstring required

Id da cobrança

dueDatestring date

Data do vencimento da cobrança

overDueDatestring date

Data de expiração da cobrança

createdAtstring

Data da criação

amountnumber

Valor

batchIdstring

Id do lote

deliveryMediumsstring[]
status'CANCELED' | 'CANCELING' | 'CREATED' | 'EXPIRED' | 'FAILED' | 'UPDATING' | 'PAID' | 'PROCESSING' | 'UPDATED'

Status da cobrança

type'BANKSLIP' | 'PIX_QR_CODE' | 'UTILITIES' | 'TED' | 'PIX'

Boleto de cobrança

descriptionstring
updatedAtstring

Data da atualização

Example response

{
  "collectionId": "0300e0fe-2ea4-4b01-bddf-7b23604e00c0",
  "dueDate": "2024-05-28",
  "overDueDate": "2025-04-20",
  "createdAt": "2025-04-15T21:00:44.875Z",
  "amount": 10.23,
  "batchId": "829c47f2-3b5c-4103-8d15-a55bd66ae905",
  "deliveryMediums": [
    "Email",
    "Push"
  ],
  "interest": {
    "startDate": "2023-10-02",
    "type": "FIXED_VALUE_PER_DAY",
    "value": 123
  },
  "fine": {
    "startDate": "2023-10-02",
    "type": "FIXED_VALUE",
    "value": 13
  },
  "discounts": [
    {
      "limitDate": "2023-10-10",
      "type": "FIXED_VALUE",
      "value": 13
    }
  ],
  "status": "PAID",
  "payee": {
    "document": "00000000000125",
    "fantasyName": "VECHI CONSULTORIA E PROJETOS LTDA",
    "socialName": "VECHI CONSULTORIA E PROJETOS LTDA",
    "bankCode": "208",
    "bankName": "VECHI CONSULTORIA E PROJETOS LTDA"
  },
  "payer": {
    "name": "John Due",
    "email": "user@gmail.com",
    "personType": "J",
    "phoneNumber": "123123121231",
    "taxId": "37297902000141",
    "address": {
      "type": "COMERCIAL",
      "zipCode": "00000001",
      "country": "BR",
      "state": "SP",
      "city": "SAO PAULO",
      "street": "RUA SANDBOX",
      "number": "369",
      "neighborhood": "BAIRRO SANDBOX"
    },
    "deliveryMediums": [
      "Email",
      "Push"
    ]
  },
  "description": "Descrição da cobrança",
  "detail": {
    "barCode": "20894931200004935000050017010554970003849530",
    "digitableLine": "20890050091195069626700021179601493360000000001",
    "ourNumber": "54865486214",
    "documentNumber": "PARCELA-123",
    "emv": "copiaecola",
    "pixKey": "teste@hotmail.com",
    "txId": "3214",
    "correlationId": "54865486214",
    "badCredit": {
      "type": "APPLICABLE",
      "issueDate": "2025-04-01"
    },
    "automaticPix": {
      "authorizationId": "611a3814-dc17-4d0b-b7fc-20f98ba618ee"
    }
  },
  "tags": [
    {
      "key": "name",
      "value": "value"
    }
  ],
  "updatedAt": "2025-04-15T21:00:44.875Z"
}