Custom webhooks
How to set up webhooks to integrate with external systems
Setting up custom webhooks:
Webhooks allow external systems to receive automatic notifications about events in ggCheckout. Deliveries are automatically retried up to 3 times on failure.
Setting up webhook:
- Access "Settings" in the SideBar
- Click on "Webhooks"
- Click "Add Webhook"
- Paste your endpoint URL
- Select the events you want to receive
- Save the configuration
- Test the webhook with a test transaction
Payment approved
When a sale is confirmed
Payment declined
When payment fails
Refund
When there's a return
New lead
When someone starts checkout
Important information:
Automatic retries
If your endpoint returns an error, the webhook will be automatically retried up to 3 times.
Delivery history
Webhook history is available for 7 days in the "History" tab under Settings > Webhooks.
Secret (optional)
When you set a Secret, the headers Authorization: Bearer <secret> and x-secret: <secret> are sent for validation on your server.
Product filter
You can configure the webhook to fire only for specific products or for all products.