Vendtill POS Webhook – Real-Time Notifications
Vendtill POS Webhook – Real-Time Notifications
Step-by-step
What is a Webhook?
A webhook is a way to get real-time updates from the Vendtill POS system. It helps your system or app stay updated automatically when something changes in Vendtill, like when a receipt is created, stock is added, a customer is created, or a new product is added.
Instead of checking (polling) for updates again and again, webhooks send data to you instantly when something happens.
Benefits of Using Webhooks
- Get instant updates when changes happen in Vendtill
- Easy to connect Vendtill POS with other systems (inventory, ERP, accounting, etc.)
- Saves time and improves efficiency
- Helps automate your workflow
Vendtill POS supports webhooks. Developers can use this feature to integrate with external systems and receive real-time event notifications.
What Can Webhooks Do?
Vendtill webhooks provide real-time notifications for key events in the POS system. You will receive updates when a receipt is created or updated, ensuring all sales records are promptly captured. Notifications are also sent when the stock or inventory of a product is updated, helping you manage inventory levels efficiently. Additionally, you’ll be alerted when a customer is created, edited, or deleted, keeping your customer database accurate. Finally, the system notifies you when a credit note or cash refund is created or updated, allowing you to track returns and refunds with ease.
You can receive notifications when the following events happen:
Event | Description |
inventory_levels.update | Triggered when stock of a product is updated |
products.update | Triggered when a product is created, edited, or deleted |
customers.update | Triggered when a customer is created, edited, or deleted |
receipts.update | Triggered when a receipt is created or updated |
credit_note.update | Triggered when a credit note or cash refund is created or updated |
How to Add a Webhook
You can set up webhooks in two ways:
- Using API
Use the /webhook endpoint to add webhook via API.
(For developers: visit Vendtill Developer Portal)
- Using Web Interface
Go to: https://cloud.vendtill.com/webhooks_setup
Each webhook can subscribe to only one event type. (Recommends)
The webhook URL must be unique for each event.( Recommends)
Important:
- URL must use http:// or https://
- URL must be accessible from the internet
- Format must be correct
Webhook Payload Example
When an event happens, Vendtill will send a POST request to your webhook URL with event data in JSON format.
Example: for inventory_levels.update event
json
CopyEdit
{
"merchant_id": "WFpYWmQwMkJGVWtDT3RHY1NHYjdBT0YzZE5xOD0=",
"type": "inventory_levels.update",
"created_at": "2025-06-30 12:54:31",
"inventory_levels": [
{
"product_id": "QWhxek54UkQ3eTArdml2d1NkSDVnUT09",
"shop_id": "bHF2M2pMakkzTVZ0NFh2SE1WNnNoUT09",
"product_code": "10003",
"in_stock": 10
}
]
}
Test Your Webhook
Test Your Webhook
You can test the webhook during setup:
- Use your own server
or - Use testing tools like Beeceptor
Vendtill will send a sample POST request to check if your URL is working.
Timeouts and Retry Rules
- Your server must reply with a 2xx status code (e.g. 200 OK)
- If the reply is not 2xx, it’s treated as failed
- Vendtill will retry up to 200 times over 48 hours
- If still no success, the webhook will be disabled
Related Articles
How to Enable Email Notifications in Vendtill POS
How to Enable Email Notifications in Vendtill POS Step-by-step What Are Email Notifications? Email notifications in Vendtill POS allow you to receive automatic email alerts for important business activities. You can receive notifications for the ...Time Clock Report
Time Clock Report Vendtill Back Office How to use “ Time Clock” Reports Vendtill time clock feature and reporting brings significant advantages for businesses by enabling the tracking of employees' attendance time and working hours. The associated ...Recommended and Minimum System Requirements for Vendtill Web POS
Recommended and Minimum System Requirements for Vendtill Web POS Vendtill Web POS Special Note To ensure stable performance and seamless user experience, we strongly recommend following the system requirements listed below. Using devices or ...How to Use Time Clock
How to Use Time Clock Vendtill Back office Main Menu > Settings > Features What is the Time Clock Feature in Vendtill? The Time Clock feature in Vendtill helps you track employee attendance and working hours. It allows staff to Clock In at the start ...E-commerce Integration with Vendtill POS ( WooCommerce & Shopify
E-commerce Integration with Vendtill POS ( WooCommerce & Shopify ) Help Steps Enhance your retail operations by integrating your e-commerce platform with Vendtill POS. Whether you use WooCommerce or Shopify, this integration allows you to seamlessly ...