Glossary · Data & Cloud

Webhook

A webhook is an automatic message that one system sends to another the instant an event happens, such as a payment succeeding or a form being submitted. It saves the receiving system from repeatedly asking whether anything has changed.

What it means

A webhook is a message that arrives on its own. Instead of your software asking a payment provider every few seconds whether a payment has gone through, the provider sends your software a message the moment it does. The message carries the details, your system reads it, and the next step runs immediately. Think of the difference between refreshing your inbox all day and receiving a notification.

How it differs from an API call

With an API call, your system starts the conversation and asks for data. With a webhook, the other system starts it and tells you something. Most real integrations use both: your server sends a request to create a payment link through the API, and the provider confirms the result with a webhook.

Why it matters for your business

Webhooks are what make software feel instant and reliable. A customer who pays by UPI and then closes the browser tab before the confirmation page loads still gets their order, because the confirmation reaches your server directly instead of depending on the customer's phone. Without webhooks, such payments sit in limbo and someone has to reconcile them by hand.

An example

A coaching centre in Tirunelveli sends each parent a payment link for the monthly fee. When a parent pays, the gateway sends a webhook to the centre's fee system. Within seconds the fee is marked paid, a receipt number is generated and a WhatsApp receipt goes to the parent, with nobody in the office touching a keyboard. If the centre's server happens to be down for a minute, a well-built gateway retries the message later, so the payment is not lost.

What to ask your developer

Typical webhook uses are payment confirmations, refund updates, courier status and form submissions. Before you sign off a checkout, ask how each incoming message is verified as genuine and how repeat deliveries are ignored so that a fee is never counted twice. You will meet this in the web application and e-commerce work at VS Tech Builders, and in the gateway comparison we wrote for Indian businesses. Fee-driven businesses such as coaching centres feel the benefit most.

Common questions

What happens if a webhook fails to arrive?

Reputable providers retry failed deliveries for a period, often with growing gaps, so a short outage on your server usually causes no loss. Your system should still check for gaps, for example by listing yesterday's payments from the provider's dashboard each night and comparing them with your own records. That safety net catches the rare message that never arrives.

Do I need webhooks if I only take a few online payments?

Yes, if orders must be confirmed automatically. Even a few payments a day will include customers who close the page early or lose signal at the wrong moment. Without a webhook those orders stay unpaid in your records although money has left the customer's account. If you confirm each payment by hand from the gateway dashboard, you can manage without, but it will not scale.