PayZu Conta HubWebhooks e callbacks

Reenviar entregas


Depois de corrigir o seu endpoint, recupere os avisos que ele não confirmou.

Reenvie a entrega

  • O que vai: o mesmo corpo e o mesmo X-Payzu-Delivery, com X-Payzu-Timestamp novo e a assinatura feita com o segredo atual do destino.
  • Quando: na hora. O responseCode e o responseBody da resposta são os desta tentativa.
  • Status aceitos: qualquer um, inclusive ABANDONED. Uma entrega DELIVERED continua DELIVERED mesmo que o reenvio falhe.
  • Webhook: precisa estar ativo, mas o evento não precisa mais estar na lista dele.
  • Cota: até 20 chamadas por minuto por conta.
bash
curl --request POST \
  --url 'https://api.sandbox.payzu.dev/api/v1/transactions/webhooks/deliveries/cmu1r7x2k000701s6dlvr0007/resend' \
  --header 'Authorization: Bearer SEU_TOKEN'

Referência: Reenviar uma entrega de um webhook

A resposta traz a entrega inteira, como na consulta; o exemplo mostra só o que muda.

Se o aviso original já foi processado, descarte o reenvio pelo id e responda 2xx.

O id do envelope é o mesmo no aviso original e no reenvio.

Erros desta operação

CódigoHTTPMensagem
WEBHOOK_DELIVERY_NOT_FOUND404Entrega de webhook não encontrada.
WEBHOOK_DELIVERY_CALLBACK_SECRET_MISSING422A conta não tem segredo de callback; gere um antes de reenviar este aviso.
WEBHOOK_DELIVERY_DESTINATION_MISSING422Esta entrega não tem destino registrado e não pode ser reenviada.
WEBHOOK_DELIVERY_PAYLOAD_PURGED422O conteúdo deste aviso foi expurgado por tempo e não pode ser reenviado.
WEBHOOK_DELIVERY_WEBHOOK_INACTIVE422O endpoint da loja está desativado; ative-o antes de reenviar.

Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.