Evento checkout.session.async.payment.succeeded
Disparado quando o pagamento de uma checkout session é confirmado depois do
checkout.session.completed. Use este evento para liberar o produto ou serviço
em sessões que terminaram o formulário antes da confirmação financeira: Pix,
boleto, ou um cartão que o comprador escolheu depois de gerar o Pix.
data.object contém a checkout session completa no estado atual:
status: "complete" e payment_status: "paid". O método e os detalhes ficam
em payment_data.
Este evento só acontece depois de
checkout.session.completed ter sido
emitido com payment_status: "unpaid". Cartão aprovado sem um Pix antes não
passa por este evento; ele já aparece como paid no completed. Depois de
um Pix, o comprador pode pagar com cartão na mesma página, e aí o pagamento
confirmado chega por este evento com payment_data.payment_method: "credit_card". Leia o meio de pagamento em payment_data, nunca deduza pelo
evento anterior.Quando acontece
Como processar
- Registre o
iddo evento (evt_*) para processar o webhook de forma idempotente. - Use
data.object.idcomo chave da checkout session no seu sistema. - Marque o pedido como pago usando
payment_status: "paid". - Libere produto, serviço, assinatura ou reserva depois deste evento.
- Use
metadata,customereline_itemspara conciliar com seu pedido interno. - Ignore entregas duplicadas quando a sessão já estiver marcada como paga localmente.
Campos importantes
Pagamentos assíncronos
Cartão depois de um Pix
O comprador gera o Pix, recebe ocheckout.session.completed com
payment_status: "unpaid" e payment_data.payment_method: "pix", e escolhe
Cartão na mesma página. Quando o cartão é aprovado, chega este evento com
payment_data.payment_method: "credit_card"; o checkout.session.completed
não se repete. Se o cartão é recusado, nada chega: o Pix continua pagável até
vencer, e o pagamento dele também chega por este evento.
Se o comprador pagar os dois, a compra continua paga uma vez, pelo que chegou
primeiro. O outro é devolvido sozinho, no mesmo dia, como um refund com
reason: "duplicate"; veja Devolver um pagamento.
Exemplo de payload
Exemplo: cartão depois de um Pix
Mesma sessão, paga no cartão em 3x depois de o comprador gerar o Pix.data.object é o DTO completo de PublicCheckoutSession.
