PayZu Conta HubWebhooks e callbacks

Listar as entregas


Veja o estado de cada entrega, nos webhooks cadastrados e na callbackUrl, para achar os avisos que o seu endpoint não confirmou.

Liste as entregas

Cada aviso gera uma entrega por destino, num webhook cadastrado ou na callbackUrl da operação. A lista começa pela mais recente e é paginada por cursor, como as outras.

  • status e event: filtram pelo estado e pelo evento.
  • webhookId: separa os webhooks da conta. Nas entregas para a callbackUrl, ele vem null e webhookUrl traz o endereço da operação.
bash
curl --request GET \
  --url 'https://api.sandbox.payzu.dev/api/v1/transactions/webhooks/deliveries?status=FAILED&limit=20' \
  --header 'Authorization: Bearer SEU_TOKEN'

Referência: Listar as entregas dos webhooks

O id da entrega é o mesmo do envelope e do cabeçalho X-Payzu-Delivery, então dá para achar a entrega de um aviso que o seu sistema registrou.

Status da entrega

StatusDescrição
PENDINGEntrega ainda sem resposta.
DELIVEREDEntrega confirmada.
FAILEDTentativa sem 2xx, com outra prevista.
ABANDONEDTentativas esgotadas.