DiscountData
  • API Documentation
  • Introduction
  • Prerequisites
  • Authentication and Authorization
  • Endpoints
    • Get Networks
    • Get Data Plans
    • Buy Data
    • Verify Transaction
    • Get Balance
  • Webhooks
    • Data Purchase Event
    • Pending Purchase Event
    • Unsuccessful Purchase Event
Powered by GitBook
On this page

Webhooks

PreviousGet BalanceNextData Purchase Event

Last updated 1 year ago

To receive real-time updates and notifications from the DiscountData API, you can set up a webhook URL in your account dashboard. Webhooks allow you to receive HTTP callbacks or notifications whenever specific events or actions occur within the DiscountData system. By utilizing webhooks, you can stay informed and take immediate action based on these events.

Setting Up Webhook URL

Before you can start receiving webhook notifications, make sure to set up a webhook URL in your account dashboard. Here's how you can configure your webhook URL:

  1. Log in to your DiscountData account at

  2. Navigate to the Webhooks section in your account settings.

  3. Enter the URL where you want to receive webhook notifications.

  4. Save the webhook URL to activate the webhook subscription.

Please ensure that the provided URL is accessible and capable of receiving HTTP POST requests. The webhook notifications will be sent to this URL whenever the specified events occur.

Webhook Responses

The DiscountData API provides various webhook responses, allowing you to handle different events. The specific events and corresponding response payloads will depend on the actions and triggers you have subscribed to.

Some common webhook responses you may encounter include:

  • Data Purchase Event: This webhook response is triggered when a data purchase is successfully completed. It typically includes details such as the mobile number, purchased data plan, transaction ID, and timestamps.

  • Error Event: In case of any errors or issues encountered during the data purchase process, an error event webhook response will be sent. It provides information about the error, including the error code, description, and any additional details that can help you troubleshoot the issue.

  • Usage Limit Event: If a user exceeds the usage limits specified in a data plan, a webhook response will be triggered. This response provides details about the usage limit breach, including the mobile number, data plan, and usage statistics.

These are just a few examples of webhook responses you may receive. The DiscountData platform offers various other event-based notifications to keep you informed about important activities and updates related to your account.

To handle webhook responses effectively, make sure your webhook URL endpoint is capable of receiving and processing incoming requests. You may need to implement appropriate security measures to verify the authenticity and integrity of the webhook payloads.

In the subsequent sections, we will explore the details of each webhook response and the corresponding payload structures. Please refer to the relevant documentation to understand the structure and fields specific to each webhook event.

Now that you understand the basics of setting up webhooks and the available webhook responses, let's proceed to explore the individual webhook events and their payloads.

If you have any questions or need further assistance regarding webhooks or any other aspect of the DiscountData API, please feel free to contact our support team.

Let's dive into the details of each webhook response available in the DiscountData API!

https://app.discountdata.ng/public/user/settings/api