---
title: "Cobrança Direta 18x"
method: POST
path: "/charge (COPY)"
---

# Cobrança Direta 18x

`POST /charge (COPY)`

## Request

- Base URL: `https://api.iugu.com/v1`
- URL: `https://api.iugu.com/v1/charge (COPY)`
- Auth: API key in query parameter `api_token`

Cobrança simples via boleto ou cartão de crédito. [Para mais informações sobre cobrança direta](https://dev.iugu.com/docs/diferen%C3%A7a-entre-cobran%C3%A7a-direta-e-fatura)

## Request body

- object
  - `method` string: Apenas suporta "bank_slip", que é boleto bancário. Não é preenchido se enviar parâmetro token
  - `token` string: ID do Token. Não é preenchido caso o método de pagamento seja "bank_slip". Em caso de Marketplace, é possível enviar um token criado pela conta mestre.
  - `customer_payment_method_id` string: <a href="https://dev.iugu.com/reference#criar-forma-de-pagamento">ID da Forma de Pagamento do Cliente</a>. Em caso de Marketplace, é possível enviar um "customer_payment_method_id" de um Cliente criado pela conta mestre (não é preenchido caso Método de Pagamento seja "bank_slip" ou utilize "token")
  - `restrict_payment_method` boolean: Se true, restringe o método de pagamento da cobrança para o definido em `method`, que no caso será apenas `bank_slip`.
  - `customer_id` string: ID do Cliente. Utilizado para vincular a Fatura a um Cliente
  - `invoice_id` string: ID da Fatura a ser utilizada para pagamento
  - `email` string: E-mail do Cliente (não é preenchido caso seja enviado um "invoice_id")
  - `months` integer: Número de Parcelas (2 até 18), não é necessário passar 1. Não é preenchido caso o método de pagamento seja "bank_slip". O valor mínino de cada parcela é de R$5,00.
  - `discount_cents` integer: Valor de desconto, em centavos, aplicado sobre os itens criados em caso de não haver fatura vinculada à chamada.
  - `bank_slip_extra_days` integer: Define o prazo em dias para o pagamento do boleto. Caso não seja enviado, aplica-se o prazo padrão de 3 dias corridos.
  - `keep_dunning` boolean: Por padrão, a fatura é cancelada caso haja falha na cobrança, a não ser que este parâmetro seja enviado como "true". Obs: Funcionalidade disponível apenas para faturas criadas no momento da cobrança.
  - `items` object[]: Itens de cobrança da Fatura que será gerada. "price_cents" valor mínimo 100. <b> Limite de 30 items </b>
    - `description` string: Descrição do Item
    - `quantity` integer: Quantidade
    - `price_cents` integer: Preço em Centavos. Valores negativos entram como desconto no total
    - `id` string: ID do item, utilizado só em casos de edição ou remoção.
    - `_destroy` boolean: Caso `true`, remove o item de uma fatura. ID do item é obrigatório.
  - `*atenção*` object: Informações do cliente abaixo "payer" são obrigatórias para a emissão de boletos ou necessárias para seu sistema de antifraude.
  - `payer` object: Informações do cliente, obrigatórias para a emissão de boletos registrados ou necessárias para seu sistema de antifraude.
    - `cpf_cnpj` string: CPF ou CNPJ (apenas números)
    - `name` string: Nome
    - `phone_prefix` string: Prefixo do número de telefone
    - `phone` string: Número de telefone
    - `email` string: E-mail
    - `address` object: Endereço do cliente
      - `street` string: Rua
      - `number` string: Número
      - `district` string: Bairro
      - `city` string: Cidade
      - `state` string: Estado
      - `zip_code` string: CEP
      - `complement` string: Complemento (opcional)
  - `order_id` string: Número único que identifica o pedido de compra. Opcional, ajuda a evitar o pagamento da mesma fatura.
  - `soft_descriptor_light` string: Altera a descrição da cobrança no cartão de crédito do cliente final (Até 12 caracteres). Caso não seja enviado, será utilizada a descrição configurada na conta.

## Response `200`

200

## Other responses

- `400`: 400
- `422`: 422

---

[API](https://skmtc.dev/iugu/apis/tokens-e-cobran-a-direta.md) - [All operations](https://skmtc.dev/iugu/apis/tokens-e-cobran-a-direta/llms.txt) - [OpenAPI document](https://skmtc.dev/iugu/apis/tokens-e-cobran-a-direta/revisions/6fe07cda088b?raw)