Pagamentos
Cancelar um pagamento
Cancela um Payment Intent ainda não concluído, informa cancellation_reason, libera captura manual e aguarda confirmação bancária para boletos e retorna o objeto completo.
Cancela um
payment_intent que ainda não está em succeeded ou canceled.
Se havia uma autorização de cartão em requires_capture, o cancelamento
também encerra essa autorização e zera amount_capturable.
Motivo do cancelamento. É opcional; quando omitido, o objeto pode retornar
cancellation_reason: null.Somente esses quatro valores são aceitos. Os motivos gerados pela Chargefy
(
automatic, expired, failed_invoice, void_invoice) aparecem na resposta
e nos webhooks, mas não podem ser enviados na requisição — veja
o objeto. Enviar um deles responde
400.abandoned afirma que o comprador desistiu, e é você quem decide isso. Se o
prazo simplesmente acabou, quem registra é a Chargefy, com expired. Para a
validade do código Pix, leia next_action.pix_display_qr_code.expires_at.Resposta
200 OK com o objeto payment_intent completo. Para boleto ainda pagável, cancellation_requested_at registra o pedido e o pagamento aguarda o banco confirmar. canceled_at só é preenchido quando o estado passa a canceled. O motivo informado é preservado desde o pedido; ele sozinho não prova o cancelamento.
Se o comprador pagar antes ou depois da confirmação bancária, o Payment Intent passa a succeeded e payment.intent.succeeded é enviado. Uma fatura anulada continua anulada, e uma assinatura cancelada não é reativada. O valor fica com a organização, que decide se o devolve ao comprador.
Para cancelar apenas o boleto e manter a cobrança disponível por outro meio, use Cancelar boleto.
Erros comuns
Os demais erros retornados pela rede usam o código específico documentado em
Códigos de falha. Uma resposta
5xx
não é autorização para repetir uma operação financeira.
Webhook gerado
O cancelamento emitepayment.intent.canceled.
O evento carrega o Payment Intent completo em data.object e pode trazer os
valores anteriores em data.previous_attributes.
Atualize sua operação de negócio de forma idempotente: a resposta da API e o
webhook representam a mesma transição e não devem produzir dois efeitos.
Motivos e timestamps
Semântica completa de cancelamento e expiração.
Cancelar uma cobrança
Regra local, idempotência e nova tentativa.

