Pular para o conteúdo principal
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_intent precisa ter payment_method: "boleto" e estar em status: "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 em canceled també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

string
obrigatório
ID do payment intent (pi_*).

Attributes

string
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

Envie boleto_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 o payment_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.updated com o novo latest_charge e o vínculo anterior em data.previous_attributes. Quando o código fica pronto, um novo payment.intent.updated traz o boleto em data.object.next_action. A nova tentativa também recebe charge.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.