Carnê

O que é um Carnê de Pagamento?

O carnê de pagamento é uma forma estruturada de cobrança recorrente, onde múltiplas faturas são geradas antecipadamente com vencimentos programados.

📌 Conceito na API

Representa um conjunto de faturas criadas automaticamente.

Baseado em um item recorrente com valor fixo, quantidade e número de ciclos.

Permite configurar:

  • Frequência de cobrança (billingFrequency)
  • Número de cobranças/faturas (chargesByBooklet)
  • Métodos de pagamento aceitos (acceptedPaymentMethods)
  • Regras de split entre sellers (splits)
  • Descontos por método de pagamento
  • Cobrança automática ou envio manual da fatura

✅ Utilizações comuns


  • Parcelamento sem cartão de crédito (ex: via boleto ou PIX)
  • Planos de serviço com tempo definido (ex: cursos, academias, consórcios)
  • Cobranças recorrentes com número limitado de ciclos (ex: 10 meses)
  • Venda de produtos em parcelas mensais, com controle de repasse por seller

🔄 Benefícios

  • Geração automatizada de múltiplas faturas
  • Controle granular de repasse por ciclo e seller
  • Flexibilidade nos meios de pagamento
  • Ideal para vendas recorrentes com fim definido