Subotiz Webhooks enable real-time delivery of system events to merchant servers, allowing backend systems to stay synchronized as payment, subscription, and transaction states change. This mechanism supports automated workflows, reliable data synchronization, and event-driven integrations across connected systems.
Webhook Event Delivery
Webhooks operate through a server-to-server notification model, where Subotiz actively pushes event data to a merchant-defined endpoint URL. This approach removes the need for repeated API polling and ensures backend systems receive updates as events occur.
Typical scenarios include:
- Keeping payment results in sync after success or failure
- Responding to subscription lifecycle changes such as creation, updates, or cancellations
- Processing order or invoice status updates automatically
- Propagating transaction data to internal systems, CRMs, or analytics tools
Webhooks are designed exclusively for backend processing and do not affect customer-facing pages or frontend behavior.
Backend Notifications vs. Redirect URLs
Webhooks and redirect URLs serve distinct roles within the payment flow and should not be used interchangeably:
- Webhooks: Deliver event notifications to backend systems for business logic execution and data synchronization.
- Redirect URLs (Return URL / Cancel URL): Control customer navigation during checkout and influence user experience only. They do not participate in payment confirmation or transaction validation.
Each is configured independently and applies at different stages of the workflow.
Webhook Endpoint Status
Each Webhook endpoint can be managed individually through its status setting:
- Active: Events are delivered to the endpoint as they occur.
- Inactive: Event delivery is temporarily paused while the endpoint configuration is preserved.
This allows merchants to suspend notifications safely during testing, system maintenance, or incident handling without removing existing endpoints.
Webhook Management Access
Access Webhooks: Navigate to Developer > Webhooks to view all configured endpoints.
The endpoint list displays:
- Endpoint URL
- Current status (Active / Inactive)
- Number of subscribed events
Webhooks provide the foundation for event-driven integrations in Subotiz, enabling backend systems to react in real time to payment, subscription, and transaction changes. With proper configuration, Webhooks support automated processing, reduce operational overhead, and improve the stability and reliability of transaction workflows.