Verify the raw body
Check x-trippay-signature before parsing or processing the message. Apply a timestamp tolerance and compare signatures safely.
Webhooks & Events
Outgoing subscriptions deliver scoped events to an approved HTTPS endpoint.
Check x-trippay-signature before parsing or processing the message. Apply a timestamp tolerance and compare signatures safely.
Deduplicate by x-trippay-event-id. Persist the event before acknowledging it and make downstream actions idempotent.
Delivery order is not guaranteed. Re-read authoritative state when needed, and inspect failed deliveries before replaying.
Use test credentials and data during development. Request production access after integration review; financial integrations also need provider approval.
Back to developer guides