Webhooks

Receive real-time notifications about payment events.

Overview

Webhooks allow you to receive automatic notifications when events happen in your Uprails account — such as successful payments, failed transactions, refunds, and disputes. Instead of polling the API, webhooks push data to your server in real-time.

How Webhooks Work

1. You configure a webhook endpoint URL in your dashboard
2. When an event occurs, Uprails sends an HTTP POST request to your URL
3. Your server processes the event and returns a 200 status code
4. If delivery fails, Uprails retries with exponential backoff

Sections

• Setup — Configure webhook endpoints
• Event Types — All available event types
• Payload Structure — Understand the webhook payload
• Signature Verification — Verify webhook authenticity