---
title: "Emitir Boleto"
method: POST
path: "/charge"
tags: ["Charge"]
---

# Emitir Boleto

`POST /charge`

## Request body

- ChargeRequest
  - `externalId` string, required — Identificador do cliente.
  - `merchantCatagoryCode` string, nullable — Categoria do estabelecimento.
  - `expirationAfterPayment` integer, required — Dias após o vencimento que a cobraça pode ser paga. Valores aceitos de 0 a 59.
  - `duedate` string, date-time, required — Data de vencimento da cobrança.
  - `amount` number, double, required — Valor da cobrança.
  - `key` string, nullable — Chave pix da conta BaaS para recebimento.
  - `invoiceNumber` string, nullable — Número de nota fiscal.
  - `debtor` DebitParty, required
    - `name` string, required — Nome do Pagador.
    - `document` string, required — CNPJ ou CPF do pagador.
    - `postalCode` string, required — CEP do pagador.
    - `publicArea` string, required — Nome da rua do pagador.
    - `number` string, required — Número da Residência.
    - `complement` string, nullable — Complemento.
    - `neighborhood` string, required — Bairro do pagador.
    - `city` string, required — Cidade do pagador.
    - `state` string, required — Estado do pagador.
  - `receiver` CreditParty, required
    - `document` string, required — CNPJ ou CPF do beneficiário.
    - `account` string, required — Número da conta BaaS do beneficiário.
  - `instructions` Instructions
    - `fine` number, double, nullable — Taxa de multa a ser cobrada.
    - `interest` number, double, nullable — Taxa de juros a ser cobrada.
    - `discount` Discount — Classe `Discount` Modelo de desconto do pagamento.
      - `discountType` 'DATA_FIXA' | 'DIA_CORRIDO' | 'DIA_UTIL' — Valores `DiscountType` Código de Desconto do pagamento.<p>Values:</p><ul><li><i>DATA_FIXA</i> - Valor Fixo até a data informada. Permite até 3 registros de desconto, sendo obrigatório especificar o valor e a data limite.</li><li><i>DIA_CORRIDO</i> - Valor por antecipação dia corrido. Permite apenas um único registro de desconto (discountOne) e só o atributo value deve ser preenchido</li><li><i>DIA_UTIL</i> - Valor por antecipação dia útil. Permite apenas um único registro de desconto (discountOne) e só o atributo value deve ser preenchido</li></ul>
      - `discountOne` DiscountInfo — Classe `DiscountInfo` Modelo de informação de desconto do pagamento.
        - `value` number, double — Propriedade `Value` Valor de Desconto do pagamento.
        - `limitDate` string, nullable — Propriedade `LimitDate` Data de Desconto do pagamento.
      - `discountTwo` DiscountInfo — Classe `DiscountInfo` Modelo de informação de desconto do pagamento.
        - `value` number, double — Propriedade `Value` Valor de Desconto do pagamento.
        - `limitDate` string, nullable — Propriedade `LimitDate` Data de Desconto do pagamento.
      - `discountThree` DiscountInfo — Classe `DiscountInfo` Modelo de informação de desconto do pagamento.
        - `value` number, double — Propriedade `Value` Valor de Desconto do pagamento.
        - `limitDate` string, nullable — Propriedade `LimitDate` Data de Desconto do pagamento.
    - `discountTwo` Discount — Classe `Discount` Modelo de desconto do pagamento.
      - `discountType` 'DATA_FIXA' | 'DIA_CORRIDO' | 'DIA_UTIL' — Valores `DiscountType` Código de Desconto do pagamento.<p>Values:</p><ul><li><i>DATA_FIXA</i> - Valor Fixo até a data informada. Permite até 3 registros de desconto, sendo obrigatório especificar o valor e a data limite.</li><li><i>DIA_CORRIDO</i> - Valor por antecipação dia corrido. Permite apenas um único registro de desconto (discountOne) e só o atributo value deve ser preenchido</li><li><i>DIA_UTIL</i> - Valor por antecipação dia útil. Permite apenas um único registro de desconto (discountOne) e só o atributo value deve ser preenchido</li></ul>
      - `discountOne` DiscountInfo — Classe `DiscountInfo` Modelo de informação de desconto do pagamento.
        - `value` number, double — Propriedade `Value` Valor de Desconto do pagamento.
        - `limitDate` string, nullable — Propriedade `LimitDate` Data de Desconto do pagamento.
      - `discountTwo` DiscountInfo — Classe `DiscountInfo` Modelo de informação de desconto do pagamento.
        - `value` number, double — Propriedade `Value` Valor de Desconto do pagamento.
        - `limitDate` string, nullable — Propriedade `LimitDate` Data de Desconto do pagamento.
      - `discountThree` DiscountInfo — Classe `DiscountInfo` Modelo de informação de desconto do pagamento.
        - `value` number, double — Propriedade `Value` Valor de Desconto do pagamento.
        - `limitDate` string, nullable — Propriedade `LimitDate` Data de Desconto do pagamento.
    - `discountThree` Discount — Classe `Discount` Modelo de desconto do pagamento.
      - `discountType` 'DATA_FIXA' | 'DIA_CORRIDO' | 'DIA_UTIL' — Valores `DiscountType` Código de Desconto do pagamento.<p>Values:</p><ul><li><i>DATA_FIXA</i> - Valor Fixo até a data informada. Permite até 3 registros de desconto, sendo obrigatório especificar o valor e a data limite.</li><li><i>DIA_CORRIDO</i> - Valor por antecipação dia corrido. Permite apenas um único registro de desconto (discountOne) e só o atributo value deve ser preenchido</li><li><i>DIA_UTIL</i> - Valor por antecipação dia útil. Permite apenas um único registro de desconto (discountOne) e só o atributo value deve ser preenchido</li></ul>
      - `discountOne` DiscountInfo — Classe `DiscountInfo` Modelo de informação de desconto do pagamento.
        - `value` number, double — Propriedade `Value` Valor de Desconto do pagamento.
        - `limitDate` string, nullable — Propriedade `LimitDate` Data de Desconto do pagamento.
      - `discountTwo` DiscountInfo — Classe `DiscountInfo` Modelo de informação de desconto do pagamento.
        - `value` number, double — Propriedade `Value` Valor de Desconto do pagamento.
        - `limitDate` string, nullable — Propriedade `LimitDate` Data de Desconto do pagamento.
      - `discountThree` DiscountInfo — Classe `DiscountInfo` Modelo de informação de desconto do pagamento.
        - `value` number, double — Propriedade `Value` Valor de Desconto do pagamento.
        - `limitDate` string, nullable — Propriedade `LimitDate` Data de Desconto do pagamento.
  - `split` SplitCreditParty[], nullable
    - `account` string, required — Número da conta BaaS do beneficiário parcial.
    - `document` string, required — CNPJ ou CPF do beneficiário parcial.
    - `percent` number, double, nullable — Porcentagem de recebimento parcial.
    - `amount` number, double, nullable — Valor fixo de recebimento parcial.
    - `aggregatePayment` boolean, nullable — Indicador para recebimento de valor fixo com acréscimo de porcentagem.
  - `bankEmissor` integer, nullable — Código do banco emissor.
  - `informations` string[], nullable — Informações Personalizadas do Boleto Array de String com 3 itens no máximo Cada item com no máximo 70 caracteres
  - `chargeType` 'BOLETO' | 'BOLEPIX'

## Response `201`

Created

- ChargeResultCelcoinResponse
  - `version` string, nullable — Versão da api.
  - `status` string, nullable — Status.
  - `body` ChargeResult
    - `transactionId` string, nullable — Identificador interno gerado pela Celcoin.

## Other responses

- `400` — Error handled by the application
- `401` — Access Denied
- `403` — Forbidden
- `500` — Unknown error

---

[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)