---
title: "Cobrança Direta"
method: POST
path: "/charge"
---

# Cobrança Direta

`POST /charge`

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`. **O token é de uso único** — Se já tiver sido utilizado numa cobrança, mesmo que a chamada tenha sido mal sucedida, deve-se criar um novo token. 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é 12), 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.net/iugu/apis/tokens-de-api.md) · [All operations](https://skmtc.net/iugu/apis/tokens-de-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iugu/tokens-de-api/revisions/4590fc729d1e/schema)