openapi: 3.2.0
info:
  title: tokens-e-cobrança-direta Charge API
  version: '1.0'
servers:
- url: https://api.iugu.com/v1
security:
- sec0: []
tags:
- name: Charge
paths:
  /charge:
    post:
      summary: Cobrança Direta
      description: Cobrança simples via boleto ou cartão de crédito. Para mais informações sobre cobrança direta
      operationId: cobranca-direta
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                method:
                  type: string
                  description: Apenas suporta "bank_slip", que é boleto bancário. Não é preenchido se enviar parâmetro token
                token:
                  type: string
                  description: 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:
                  type: string
                  description: <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:
                  type: boolean
                  description: 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:
                  type: string
                  description: ID do Cliente. Utilizado para vincular a Fatura a um Cliente
                invoice_id:
                  type: string
                  description: ID da Fatura a ser utilizada para pagamento
                email:
                  type: string
                  description: E-mail do Cliente (não é preenchido caso seja enviado um "invoice_id")
                months:
                  type: integer
                  description: 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.
                  format: int32
                discount_cents:
                  type: integer
                  description: Valor de desconto, em centavos, aplicado sobre os itens criados em caso de não haver fatura vinculada à chamada.
                  format: int32
                bank_slip_extra_days:
                  type: integer
                  description: 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.
                  format: int32
                keep_dunning:
                  type: boolean
                  description: '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:
                  type: array
                  description: Itens de cobrança da Fatura que será gerada. "price_cents" valor mínimo 100. <b> Limite de 30 items </b>
                  items:
                    properties:
                      description:
                        type: string
                        description: Descrição do Item
                      quantity:
                        type: integer
                        description: Quantidade
                        format: int32
                      price_cents:
                        type: integer
                        description: Preço em Centavos. Valores negativos entram como desconto no total
                        format: int32
                      id:
                        type: string
                        description: ID do item, utilizado só em casos de edição ou remoção.
                      _destroy:
                        type: boolean
                        description: Caso `true`, remove o item de uma fatura. ID do item é obrigatório.
                    type: object
                '*atenção*':
                  type: object
                  description: Informações do cliente abaixo "payer" são obrigatórias para a emissão de boletos ou necessárias para seu sistema de antifraude.
                  properties: {}
                payer:
                  properties:
                    cpf_cnpj:
                      type: string
                      description: CPF ou CNPJ (apenas números)
                    name:
                      type: string
                      description: Nome
                    phone_prefix:
                      type: string
                      description: Prefixo do número de telefone
                    phone:
                      type: string
                      description: Número de telefone
                    email:
                      type: string
                      description: E-mail
                    address:
                      type: object
                      description: Endereço do cliente
                      properties:
                        street:
                          type: string
                          description: Rua
                        number:
                          type: string
                          description: Número
                        district:
                          type: string
                          description: Bairro
                        city:
                          type: string
                          description: Cidade
                        state:
                          type: string
                          description: Estado
                        zip_code:
                          type: string
                          description: CEP
                        complement:
                          type: string
                          description: Complemento (opcional)
                  required: []
                  type: object
                  description: Informações do cliente, obrigatórias para a emissão de boletos registrados ou necessárias para seu sistema de antifraude.
                order_id:
                  type: string
                  description: Número único que identifica o pedido de compra. Opcional, ajuda a evitar o pagamento da mesma fatura.
                soft_descriptor_light:
                  type: string
                  description: 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.
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "//credit_card response\n{\n  \"message\": \"Autorizado\",\n  \"errors\": {},\n  \"status\": \"captured\",\n  \"info_message\": \"Transação capturada\",\n  \"reversible\": null,\n  \"token\": \"token4\",\n  \"brand\": null,\n  \"bin\": null,\n  \"last4\": null,\n  \"issuer\": null,\n  \"success\": true,\n  \"url\": \"https://checkout.iugu.dev/invoices/b332de4d-61aa-4e0c-ae3a-945b29b07eca-53d4\",\n  \"pdf\": \"https://checkout.iugu.dev/invoices/b332de4d-61aa-4e0c-ae3a-945b29b07eca-53d4.pdf\",\n  \"identification\": null,\n  \"invoice_id\": \"B332DE4D61AA4E0CAE3A945B29B07ECA\",\n  \"LR\": \"00\"\n}\n\n//bank_slip response\n{\n  \"success\": true,\n  \"url\": \"https://checkout.iugu.com/invoices/d819a14d-cb10-4c1d-80c7-e14d040a18cc-5213?bs=true\",\n  \"pdf\": \"https://checkout.iugu.com/invoices/d819a14d-cb10-4c1d-80c7-e14d040a18cc-5213.pdf\",\n  \"bank_slip_url\": \"https://boletos.iugu.com/v1/public/invoice/d819a14d-cb10-4c1d-80c7-e14d040a18cc-5213/bank_slip\",\n  \"bank_slip_pdf_url\": \"https://boletos.iugu.com/v1/public/invoice/d819a14d-cb10-4c1d-80c7-e14d040a18cc-5213/bank_slip.pdf\",\n  \"identification\": \"40192025089200000000700002597151910420000005000\",\n  \"invoice_id\": \"D819A14DCB104C1D80C7E14D040A18CC\"\n}"
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: "//credit_cart return\n{\n  \"errors\": \"token não é válido\"\n}\n\n//bank_slip return\n{\n  \"errors\": \"credit_cards não é suportado. (Métodos suportados: bank_slip)\"\n}"
        '422':
          description: '422'
          content:
            application/json:
              examples:
                Un.Entity:
                  value: "{\n  \"errors\": {\n    \"total\": [\n      \"deve ser maior que 1\" /* \"price_cents\" deve ser maior que 100 */\n    ]\n  }\n}\n\n//bank_slip return\n{\n  \"errors\": {\n    \"payer.cpf_cnpj\": [\n      \"não pode ficar em branco\"\n    ],\n    \"payer.name\": [\n      \"não pode ficar em branco\"\n    ],\n    \"payer.address.zip_code\": [\n      \"não pode ficar em branco\",\n      \"não é válido\"\n    ],\n    \"payer.address.number\": [\n      \"não pode ficar em branco\"\n    ]\n  }\n}"
      deprecated: false
      tags:
      - Charge
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: query
      name: api_token
x-readme-fauxas: true
x-provenance:
  method: searched
  source: https://dev.iugu.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://dev.iugu.com/reference/cobranca-direta-com-2-cartoes.md
  - https://dev.iugu.com/reference/cobranca-direta.md
  - https://dev.iugu.com/reference/criar-token.md
  - https://dev.iugu.com/reference/listar-api-tokens.md
  - https://dev.iugu.com/reference/reemissao-de-fatura-expirada.md
  merge:
    pages: 5
    deduped: 4
    conflicts_kept_first: 0