# About Webhooks

Webhooks (Web Callback, HTTP Push API, or Reverse API) are one way that a web application can send information to another application in real-time when a specific event happens.

#### Example

Suppose you have added the webhook from your vendor panel's webhook setting and your webhook endpoint is successfully connected, then you will receive a notification every time a recharging status changes either to successful or failed.

### Webhook vs API

APIs send you the data when you request it. For Webhooks, you do not need to make a request. You receive the data when it is available.

**Example**

If you need to know whether a recharge is a success or not, using APIs, you need to keep polling every few seconds until you get the success status for the recharge. However, if you are using Webhooks, you can configure a Webhook handling URL to receive notifications when a recharge gets to success status.

### Use Cases <a href="#use-cases" id="use-cases"></a>

There can be multiple uses for webhook events. Two of these are listed below.

#### Capturing Success Recharges <a href="#capturing-late-authorized-payments" id="capturing-late-authorized-payments"></a>

Capturing recharge status for which you did not receive a response immediately is perhaps the most important use case for the webhook event.

Sometimes, the communication between the recharge provider and Globaltopup or between you and Globaltopup may not occur. This could be because of a slow network connection or your customer closing the window while processing the recharge. This could lead to a recharge being marked as **queued** on the Globaltopup Dashboard but changed to **Success or Failed** at a later time.&#x20;

#### Notifications on Failed Recharges <a href="#notifications-on-failed-payments" id="notifications-on-failed-payments"></a>

When a recharge attempted by your customer fails, we receive the failed payment status from the recharge provider. This payment gets recorded in our system as **Failed**.

Suppose you have enabled the webhook, you will receive a notification from us about the failed payment. You can then further analyze this payment and notify your customer about the failure.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.globaltopup.in/developer-tools/about-webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.