Pagamentos
Regenerar o boleto de um pagamento
Regenera o boleto encerrado de um Payment Intent, preserva o ID e retorna novo vencimento, next_action e latest_charge.
Emite um boleto novo depois que a tentativa anterior terminou — mesma PI,
mesmo
client_secret, novo latest_charge, novo
next_action.boleto_display_details. Quando o banco confirma que um boleto
venceu sem pagamento, o intent volta a requires_payment_method — a tentativa
acabou, o intent não — e esta ação inicia a próxima tentativa. Um boleto ainda
ativo precisa ser cancelado por Cancelar boleto antes da reemissão.
Depois de aceito o pedido, é possível emitir outro boleto sem aguardar a confirmação bancária. Isso inclui os dias depois do vencimento em que a confirmação do
banco ainda não chegou: um pagamento feito no último dia pode ser compensado.
Para a primeira emissão do boleto de uma fatura, use
POST /v1/invoices/{id}/issue_boleto.
Restrições
- O cliente do pagamento precisa ter nome, CPF/CNPJ e endereço. No Brasil: rua, bairro, cidade, estado e CEP; o estado pode vir como sigla ou por extenso e, sem estado, é deduzido do CEP. Nos demais países: rua e cidade.
- O
payment_intentprecisa terpayment_method: "boleto"e estar emstatus: "requires_payment_method"— o estado em que o intent fica depois que o banco confirma o vencimento (em geral de 2 a 3 dias úteis após a data; no máximo 10 dias). Intents emcanceledtambém são aceitos e voltam ao fluxo com o boleto novo quando elegíveis. - 1 reemissão por hora por Payment Intent. Chamadas mais frequentes retornam
429. - Sem limite total de reemissões — pode chamar quantas vezes precisar, respeitando o limite de frequência.
Parâmetros de caminho
Attributes
Nova data de vencimento no formato
YYYY-MM-DD: hoje, amanhã ou qualquer dia
futuro. Um dia que já passou retorna 400. Sem ela, o boleto de um payment
intent de fatura vence com a fatura, inclusive hoje; se a fatura já venceu, e
nos demais casos, vence em hoje + 3 dias. “Hoje” é o dia em Brasília.Com o vencimento padrão
Sem corpo, a Chargefy escolhe o dia pela regra acima.Com vencimento escolhido
Envieboleto_due_date para escolher o dia. Chamada às 15h de 1º/06 com
"2026-06-01" emite um boleto pagável até 1º/06 às 23h59; com "2026-05-31",
retorna 400.
Resposta
Retorna opayment_intent atualizado com o novo next_action. O campo
regenerated_at é atualizado para o momento da chamada.
Efeitos colaterais
- A tentativa anterior está encerrada ou com cancelamento solicitado. Nesse último caso, o banco ainda pode aceitar o boleto anterior até confirmar o cancelamento; não instrua o comprador a pagar os dois documentos.
- O encerramento automático do boleto antigo é cancelado e um novo é agendado
a partir do novo
expires_at. - Ao vincular a tentativa, a Chargefy emite
payment.intent.updatedcom o novolatest_chargee o vínculo anterior emdata.previous_attributes. Quando o código fica pronto, um novopayment.intent.updatedtraz o boleto emdata.object.next_action. A nova tentativa também recebecharge.updated.
Erros comuns
Fluxo de boleto
Emissão, vencimento, expiração e eventos.
Objeto Payment Intent
Campos de
next_action.boleto_display_details e timestamps.
