Skip to main content
POST
Replay a past event
Encola una nueva entrega webhook contra tu URL actual con el secreto actual. El X-ZoPay-Event-Id será el mismo evt_… que la entrega original — tu handler debe deduplicar por ese id.
  • Idempotencia obligatoria. Misma (org, Idempotency-Key, body) dentro de 24h devuelve la entrega original sin encolar otra.
  • Replayable siempre. Incluso eventos que ya entregaron 2xx pueden replicarse.
  • Auditoría acumulativa. Cada replay crea una fila nueva en webhook_deliveries — el historial crece, no muta.
Concepto en Events.

Authorizations

Authorization
string
header
required

Paste your Connect API key (sk_live_… for production, sk_test_… for sandbox) without the Bearer prefix. Mint and rotate keys from the admin panel.

Headers

Idempotency-Key
string | null

Path Parameters

event_id
string
required

Event id to replay, beginning with evt_. Same 404-on-anything-that-doesn't-match semantics as the single-event GET endpoint.

Response

Successful Response

Body of POST /connect/v1/events/:id/replay.

Returns the newly-enqueued webhook_deliveries row's id and initial state. Partners poll their dashboard / GET /webhook-deliveries to watch the replay's lifecycle; the delivery's terminal state (delivered / failed / exhausted) is set asynchronously by the cron worker.

id
string
required

The new webhook_deliveries row id (UUID, rendered as string). Distinct from the original delivery's id if this event was delivered before; each replay produces a fresh row for audit clarity.

object
string
required

Always webhook_delivery. Stripe-style discriminator so polymorphic partner-side handlers can dispatch.

event_id
string
required

The connect_events id the delivery row points at. Identical to the path-param event_id -- echoed for convenience.

status
string
required

Always pending on the response. The worker claims the row on its next tick and transitions it through processing to a terminal state (delivered / failed / exhausted).

attempt_count
integer
required

Always 0 on the response. The worker increments this on each attempt; a replay starts with a fresh budget.