Webhook de link de pagamento

Quando o link tem webhookUrl, a YumePay envia um POST ao concluir cada tentativa de pagamento no checkout.

{
  "event": "payment_link.paid",
  "data": { "id": 18, "status": 4, "value": 990 }
}

Evento	Quando
payment_link.paid	Pagamento aprovado. status: 4
payment_link.denied	Tentativa recusada. status: 7. O pagador pode tentar de novo no mesmo link

Campo	Descrição
data.id	ID do link (o id da seção Criar link de pagamento)
data.status	Status numérico do link — ver Referência de status
data.value	Valor em centavos

Este webhook é enviado uma única vez, sem reenvio

Se o seu endpoint estiver fora do ar, a notificação se perde. Use GET /api/v1/payment-links/:id/ como fonte de verdade e para conciliar links pendentes.

Assinatura HMAC e regras do endpoint: ver Webhooks de cobrança.