Pular para o conteúdo principal

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 id do evento (evt_*) para processar o webhook de forma idempotente.
  • Use data.object.id como 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, customer e line_items para 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 o checkout.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.