---
title: "Criar cobrança com vencimento"
method: POST
path: "/pix/v1/collection/duedate"
---

# Criar cobrança com vencimento

`POST /pix/v1/collection/duedate`

Essa API possibilita que seja realizado o vinculo de um QR Code a uma cobrança com vencimento, multa, juros, ou abatimentos (COBV).

## Request body

- object
  - `clientRequestId` string, required — Identificador único da transação fornecida pelo cliente. Este valor não pode ser repetido.
  - `expirationAfterPayment` integer, required — Dias para expiração da cobrança após o vencimento.
  - `duedate` string, date, required — Data de vencimento.
  - `debtor` object, required — Dados do pagador para cobranças com vencimento (COBV)
    - `name` string, required — Nome do pagador que receberá esta cobrança.
    - `cpf` string — Documento único de identificação brasileiro de pessoa física (CPF). Campo obrigatório para pessoa física.
    - `cnpj` string — Documento único de identificação brasileiro de pessoa jurídica (CNPJ). Campo obrigatório para pessoa jurídica.
    - `city` string — Nome da cidade.
    - `publicArea` string — Nome da rua
    - `state` string — Sigla do estado.
    - `postalCode` string — CEP da rua.
    - `email` string — Email de contato.
  - `receiver` object, required — Dados do recebedor para cobranças com vencimento (COBV)
    - `name` string, required — Nome do recebedor
    - `cpf` string — Documento único de identificação brasileiro de pessoa física (CPF). Campo obrigatório para pessoa física.
    - `cnpj` string — Documento único de identificação brasileiro de pessoa jurídica (CNPJ). Campo obrigatório para pessoa jurídica.
    - `postalCode` string, required — CEP da rua.
    - `city` string, required — Nome da cidade
    - `publicArea` string, required — Nome da rua.
    - `state` string, required — Sigla do estado.
    - `fantasyName` string — Nome fantasia para pessoa jurídica.
  - `locationId` integer, required — Identificador único do BRCode a ser associado a cobrança.
  - `amount` number, double, required — Valor original desta cobrança.
  - `amountDicount` object — Desconto a ser oferecido de acordo com a modalidade escolhida.
    - `discountDateFixed` object[] — Listagem de datas, valores e porcentagens para desconto por dia. Esse campo deve ser preenchido para as seguintes modalidades ( modality ): FIXED_VALUE_UNTIL_THE_DATES_INFORMED PERCENTAGE_DATE_REPORTED
      - `date` string, required — Data para aplicação do desconto.
      - `amountPerc` string, required — Valor ou porcentagem que será submetida ao valor original por dia.
    - `hasDicount` boolean — Campo destinado a informar se haverá (true) ou não (false) desconto para esta cobrança.
    - `modality` 'FIXED_VALUE_UNTIL_THE_DATES_INFORMED' | 'PERCENTAGE_DATE_REPORTED' | 'AMOUNT_PER_CALENDAR_DAY_ADVANCE' | 'AMOUNT_ADVANCE_BUSINESS_DAY' | 'PERCENTAGE_ADVANCE_CURRENT_DAY' | 'PERCENTAGE_ADVANCE_BUSINESS_DAY' — Modalidades de desconto. Siga a tabela de ENUM para descontos na documentação.
    - `amountPerc` string — Abatimentos ou outras deduções aplicadas, em valor absoluto ou percentual do valor original. Esse campo deve ser preenchido para as seguintes modalidades ( modality ): AMOUNT_PER_CALENDAR_DAY_ADVANCE AMOUNT_ADVANCE_BUSINESS_DAY PERCENTAGE_ADVANCE_CURRENT_DAY PERCENTAGE_ADVANCE_BUSINESS_DAY
  - `amountAbatement` object — Abatimento consedido de acordo com a modalidade escolhida.
    - `hasAbatement` boolean — Campo destinado a informar se haverá ou não abatimento para esta cobrança.
    - `amountPerc` string — Valor ou percentual de abatimento a ser aplicado.
    - `modality` 'FIXED_VALUE' | 'PERCENT' — Modalidades de abatimento.
  - `amountFine` object — Multa aplicada de acordo com a modalidade escolhida.
    - `hasFine` boolean — Campo destinado a informar se haverá ou não multa para esta cobrança.
    - `amountPerc` string — Valor ou percentual de multa a ser aplicado.
    - `modality` 'FIXED_VALUE' | 'PERCENT' — Modalidades de multa. Siga a tabela de ENUM para multa na documentação.
  - `amountInterest` object — Juros aplicado de acordo com a modalidade escolhida.
    - `hasInterest` boolean — Campo destinado a informar se haverá ou não juros para esta cobrança.
    - `amountPerc` string — Valor ou percentual de juros a ser aplicado.
    - `modality` 'VALUE_CALENDAR_DAYS' | 'PERCENTAGE_PER_DAY_CALENDAR_DAYS' | 'PERCENTAGE_PER_MONTH_CALENDAR_DAYS' | 'PERCENTAGE_PER_YEAR_CALENDAR_DAYS' | 'VALUE_WORKING_DAYS' | 'PERCENTAGE_PER_DAYWORKING_DAYS' | 'PERCENTAGE_PER_MONTH_WORKING_DAYS' | 'PERCENTAGE_PER_YEAR_WORKING_DAYS' — Modalidades de juros.
  - `additionalInformation` object[] — Uma listagem de chave e valor contendo informações adicionais a serem apresentadas no ato do pagamento.
    - `value` string — Valor atrelado a chave como informação adicional a cobrança.
    - `key` string — Chave de referência do valor
  - `payerQuestion` string — Uma mensagem a ser mostrada ao pagador no momento do pagamento, com no máximo 140 caracteres.
  - `key` string, required — Chave Pix que contém as informações de liquidação de pagamento.

## Response `200`

200

- object
  - `transactionIdentification` string
  - `transactionId` integer
  - `clientRequestId` string
  - `status` string
  - `lastUpdate` string
  - `payerQuestion` unknown
  - `additionalInformation` unknown
  - `debtor` object
    - `name` string
    - `cpf` unknown
    - `cnpj` string
  - `amount` object
    - `original` number
    - `discount` object
      - `discountDateFixed` object[]
        - `date` string
        - `amountPerc` string
      - `modality` string
    - `abatement` unknown
    - `fine` unknown
    - `interest` unknown
  - `location` object
    - `merchant` object
      - `postalCode` string
      - `city` string
      - `merchantCategoryCode` string
      - `name` string
    - `url` string
    - `emv` string
    - `type` string
    - `locationId` string
    - `id` unknown
  - `key` string
  - `receiver` object
    - `name` string
    - `fantasyName` string
    - `cpf` unknown
    - `cnpj` string
  - `calendar` object
    - `expirationAfterPayment` string
    - `createdAt` string
    - `dueDate` string
  - `createAt` string

## Other responses

- `400` — 400
- `401` — 401
- `500` — 500

---

[API](https://skmtc.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/revisions/85dd6188a37b/schema)