Pular para o conteúdo principal
Marca uma invoice open como void. Invoices pagas não podem ser canceladas por este endpoint; use o fluxo apropriado da cobrança quando precisar devolver um pagamento já capturado. A anulação é definitiva. Enquanto um pagamento estiver em processamento ou aguardando confirmação, o endpoint retorna 409 com code: resource_state_conflict e preserva a fatura e o pagamento. Aguarde o resultado antes de tentar novamente. Se o cartão já foi aprovado, use o fluxo de estorno da cobrança. Pix ou boletos já emitidos podem ter sua fatura anulada, desde que não exista outra tentativa em processamento ou um recebimento já confirmado. Quando uma invoice é cancelada, uma URL ativa em hosted_invoice_url continua apontando para a página da invoice, mas ela fica apenas para visualização e não aceita pagamento.
string
obrigatório
ID da invoice (inv_*).

Boletos pendentes

Anular a fatura também pede o cancelamento de todos os seus boletos pendentes. A confirmação do banco é assíncrona. Um recebimento posterior é registrado, sem reabrir a fatura nem reativar a assinatura: o valor fica com a organização, que decide se o devolve ao comprador. Por exemplo, um boleto de R$ 360,41 pago dois dias depois da anulação deixa o Payment Intent succeeded, gera payment.intent.succeeded e charge.succeeded e entra no saldo da organização, e a fatura continua void, sem invoice.paid.