Skip to main content
Paywint guarantees at-least-once delivery for all webhook events.
If your endpoint does not return a 2xx HTTP response, the system automatically retries.

Retry Policy

AttemptDelay after previous tryCondition
1st (initial)Original delivery
2nd~1 minuteNo 2xx response
3rd~5 minutesSecond attempt failed
After the final failed attempt, an email is sent to the registered admin address with details of the undelivered event.

Best Practices

  • Return 200 OK within 5 seconds; offload heavy work to background jobs.
  • Store and de-duplicate by event id to ensure idempotency.
  • Implement exponential backoff if you replay events from your side.
  • Monitor endpoint health (latency and error rates).