Webhook configuration in Subotiz enables merchants to receive real-time payment notifications, such as payment success or failure. This setup is required to activate Share Payment Link, subscription billing, and webhook event tracking.
Before configuring Webhooks for payment links, you can refer to the following articles for general setup guidance:
Accessing the Webhook Setup Page
- Go to Developers > Webhooks in the Subotiz admin.
- Click Create Webhook.
Completing Basic Configuration
- Enter endpoint URL: Input a valid HTTPS URL used to receive webhook notifications.
- Example:
https://your-domain.com/webhook - If no endpoint URL is available, refer to Webhook Setup Options below.
- Add description: Enter a label to identify the webhook.
- Example:
Payment notifications
Webhook Setup Options
Choose a setup method based on your technical capability:
- Developer support: Set up a backend endpoint to receive webhook events.
- Third-party tool: Use automation tools such as Zapier or Make to generate a webhook URL without building a backend service.
Selecting Required Events
To enable Share Payment Link, only minimal event selection is required.
- Minimum Required (Recommended for All Merchants)
- Payment success:
v2.trades.succeeded
- Optional (Based on Business Needs)
- Payment failure:
v2.trades.payment_failed - Subscription created:
v2.subscription.first - Subscription canceled:
v2.subscription.canceled
Selection Guidance
- One-time products: Select Payment success only.
- Subscriptions: Select Payment success and add subscription-related events.
Activating the Webhook
- Click Create and Activate.
- Verify that the webhook status displays as Active.
Requirements and Limitations
- A valid HTTPS server endpoint is required for webhook configuration to function. This typically requires a backend service or a third-party automation tool.
- Share Payment Link cannot be used without at least one active webhook configured.
Webhook configuration is a required step to enable payment link sharing in Subotiz. By configuring a valid endpoint and selecting the necessary events, merchants can activate payment links and ensure proper payment tracking and subscription management.