Subotiz Webhooks provide centralized control over event delivery to merchant backend systems. Through the Webhooks interface, merchants can create endpoints, define event subscriptions, manage delivery status, and maintain visibility across all configured integrations.
Webhook Setup Flow
Webhook configuration follows a structured setup flow that ensures events are delivered only to intended backend systems.
- Access the Webhooks page: Navigate to Developer > Webhooks to open the Webhooks management interface. This page displays all existing Webhook endpoints and provides entry points for creating, updating, and managing event destinations.
- Create a new Webhook: Select Create Webhook to open the Webhook configuration screen.
- Configure Webhook details: Provide the required information for event delivery.
- Endpoint URL: Enter a valid HTTPS URL that can receive Webhook event notifications. The endpoint must:
- Be publicly accessible
- Accept server-to-server requests
- Be managed by a trusted backend service
- Description (optional) : Enter a short label to identify the purpose of the endpoint, such as:
- Payment processing
- Subscription lifecycle synchronization
- Internal reporting
The description is used for identification and management purposes only.
- Select event subscriptions: Choose the events this Webhook endpoint should receive. Only selected events are delivered.
- Subscription
- Trial period expiration
- First subscription charge
- Subscription cancellation
- Subscription price changes
- Invoice
- Invoice payment succeeded
- Invoice payment failed
- Invoice refunded
- Trade
- Transaction succeeded
- Transaction payment failed
- Refund
- Refund succeeded
- Refund failed
Event selection can be broad or targeted. Centralized processing systems may subscribe to all events, while specialized services typically select specific event types.
- Create and activate the endpoint: Select Create & activate to save the configuration.Once activated:
- The endpoint is registered immediately.
- Event delivery begins based on the selected subscriptions.
- The endpoint appears in the Webhooks list with an Active status.
Managing Existing Webhooks
After creation, Webhook endpoints remain fully manageable from the Webhooks list.
- Edit Webhook configuration: Select Edit from the endpoint action menu to update:
- Endpoint URL
- Description
- Subscribed event types
Changes take effect immediately after saving.
- Pause event delivery: Select Deactivate to pause event delivery for an endpoint.
- No events are sent to the endpoint.
- Configuration and event selections are preserved.
- Delivery can be resumed later without reconfiguration.
This is commonly used during system maintenance or endpoint migrations.
Webhook List Controls
The Webhooks list includes built-in controls for managing multiple endpoints efficiently.
- Search by endpoint URL: Enter part or all of an endpoint URL to narrow the list to matching entries.
- Filter by status: Use the Status filter to display:
- Active endpoints currently receiving events.
- Inactive endpoints with delivery paused.
- Reset list view: Select Reset to clear all search and filter conditions and return to the full Webhooks list.
Best Practices
- Each Webhook endpoint receives only the events explicitly selected during setup.
- Endpoints remain visible and configurable even when inactive.
- Access to Webhook creation and management should be restricted to authorized technical users.
- Each Subotiz account supports a maximum of 10 Webhook endpoints.
Webhook configuration in Subotiz follows a controlled, step-by-step flow that defines event destinations, subscriptions, and delivery behavior. By setting up endpoints deliberately and managing them through the Webhooks interface, merchants can maintain reliable, scalable, and well-governed event-driven integrations.