This document provides comprehensive information about webhooks in the Qariyb platform.

Table of Contents

• Overview
• Creating a Webhook
• Authentication & Security
• Payload Structure
• Webhook Events
  • Event Lifecycle
  • Orders & Tickets
  • Attendees
  • Payments
• Verifying Webhook Signatures
• Best Practices

Overview

Qariyb webhooks allow you to receive real-time HTTP notifications when events occur on the platform. When an event happens (e.g., a ticket is purchased, an attendee checks in), Qariyb sends a POST request to your configured endpoint with details about the event.

Key Features:

• Event-scoped webhooks (each webhook is tied to a specific event)
• HMAC-SHA256 payload signing for security
• Multiple authentication options
• Automatic retries (3 attempts with 60-second delays)
• Delivery logging and monitoring

Creating a Webhook