Event Replay

Re-send webhook events that were missed or failed delivery. Useful for recovering from downtime or debugging.

Replay an Event

POST /api/v1/hook/replay
Content-Type: application/json

{
  "eventId": "event-uuid-123"
}

List Events

View all events that have been generated for your account:

GET /api/v1/hook/event?limit=50&offset=0

Response:

{
  "events": [
    {
      "id": "event-uuid-123",
      "event": "payment.completed",
      "timestamp": "2026-01-15T10:25:00Z",
      "destination": "https://yourserver.com/webhooks/wickiepay",
      "status": "DELIVERED",
      "attempts": 1
    },
    {
      "id": "event-uuid-456",
      "event": "payment.expired",
      "timestamp": "2026-01-15T09:00:00Z",
      "destination": "https://yourserver.com/webhooks/wickiepay",
      "status": "FAILED",
      "attempts": 3
    }
  ]
}

Event Delivery Status

Status	Description
DELIVERED	Successfully delivered (received 200 OK)
FAILED	All delivery attempts failed
PENDING	Queued for delivery or awaiting retry

When to Use Replay

• Server downtime — Your webhook endpoint was unreachable
• Processing errors — Your handler returned a non-200 status
• Lost data — Events were delivered but not properly stored
• Debugging — Re-trigger an event to test your handler

Automatic Retries

WickiePay automatically retries failed deliveries 3 times with exponential backoff. Use replay only if all automatic retries have been exhausted.