PayZu GatewayWebhooks

Reenviar entregas


Nesta páginaReenvie uma entregaO que muda em cada statusErros desta operação

Mande de novo, na hora, a entrega que você precisar: a que falhou, a que já foi entregue ou a que ainda espera uma nova tentativa.

Reenvie uma entrega

bash
curl -X POST https://api.sandbox.payzu.dev/v1/webhook-deliveries/whd_Aduv7DfwwLFCdrFLtEmNrd/retry \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

A resposta já traz o resultado do envio, no formato da consulta da entrega. Quando o seu endpoint aceita o reenvio, a entrega volta assim:

Trecho da resposta
{
  "id": "whd_Aduv7DfwwLFCdrFLtEmNrd",
  "status": "delivered",
  "delivered_at": "2026-11-11T15:21:04.427Z",
  "attempts": {
    "count": 2,
    "last_at": "2026-11-11T15:21:04.427Z",
    "next_at": null,
    "last_status_code": 200,
    "last_error": null
  }
}

Referência: Reenviar uma entrega

  • Corpo: o mesmo da entrega, com o mesmo id do evento.
  • Destino: o endereço atual do webhook, em webhook.url, mesmo com o webhook inactive.
  • Assinatura: nova, feita com o segredo atual.
  • Tempo: a resposta pode levar até 5 segundos, o tempo de espera pelo seu endpoint.
  • Idempotência: Idempotency-Key é opcional, como em Idempotência.

O reenvio repete o corpo guardado na entrega.

O recurso vai como estava no momento do evento, não no estado atual dele. Para o estado atual, consulte o recurso na API.

O que muda em cada status

Status da entregaO que o reenvio faz
failedUma tentativa só. A entrega fica delivered, ou failed de novo, sem reabrir as novas tentativas automáticas.
deliveredUma tentativa só. Se o seu endpoint não responder 2xx, a entrega passa a failed, com delivered_at nulo: o status é o da última tentativa.
pendingA próxima tentativa automática é feita na hora e conta como uma das 6. Se falhar, as novas tentativas automáticas seguem de onde estavam.

A entrega pending que está sendo enviada naquele instante, ou cuja próxima tentativa sai em até cerca de 1 minuto, volta como está, sem outro envio.

Um reenvio pode repetir um evento que sua aplicação já processou.

Descarte a repetição pelo id do evento, como em Webhooks.

Erros desta operação

CódigoHTTPMensagem
-404Entrega não encontrada para o id informado.

Os erros de autenticação e de idempotência estão no Catálogo de erros.