---
updatedAt: 2026-02-26T13:10:06.000Z
agentTools:
  projectIndex: https://docs.ksa.ngenius-payments.com/llms.txt
---

# Webhooks

## Overview

The **Webhooks** screen is where existing Webhooks can be viewed, and new ones created.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/8faaa9af19ee9e457bdea7759fbcaf95e6ab11753c8e7adc9e84da315a530910-image.png",
        null,
        "webhookscreen"
      ],
      "align": "center",
      "border": true
    }
  ]
}
[/block]

<br />

A Webhook allows the Merchant Admin Users and Web Developers to transfer specific payment information out of the system, to an external URL.

The Webhook event must contain the origin name, the goal URL it will be transferred to, and usually a custom header key and value. The latter two are for security purposes, and are identifiers generally corresponding to an account name or number, and the account password, API Key or similar.

The Webhook solution does not support any re-try logic. It is important the goal URL is on a reliable merchant server to ensure successful delivery.

**Open Webhooks screen**

1. Select the **Settings** option from the top Main menu bar. The Settings menu bar displays, with the **Users** page open by default.
2. Click on the **Integrations** menu option. The **Integration** settings screen displays.
3. Click on the **Webhooks** link. The **Webhooks** page displays.

## Create new webhook

1. Click the **New** button. The **Add a Webhook Event** slide-out box reveals.
2. Type in the Webhook **Name** and the goal **URL** for the new event in the appropriate fields.
3. If necessary, type in the **Custom Header Key** and **Value** in the appropriate fields.
4. Click the **Add** button. The **Add a Webhook Event** box retracts.\
   The new event displays in the Webhook events list, and a "Webhook added" confirmation message displays under the **Settings** menu.

## Enable/Disable Webhook

1. Click the  **Edit** icon beside the Webhook event you want. The <img src="https://files.readme.io/d663cd2-edit_pencil.jpg"> **Edit Webhook** Status slide-out box displays.
2. In the **Status** section, click on the **Disable/Enable** slide button to the position you want.\
   **Tip**:  A dark slide button is **Enabled** <img src="https://files.readme.io/6e43ec0-toggle-on.jpg">  An empty slide button is **Disabled** <img src="https://files.readme.io/7289cb5-toggle-off.jpg">
3. Click on the **Update** button. The **Edit Webhook Status** box retracts..\
   A "Webhook status updated" confirmation message displays under the **Settings** menu bar. In the events list, an  <img src="https://files.readme.io/1107970-dot_green.jpg"> **Enabled** green dot or  <img src="https://files.readme.io/ce49af3-dot_red.jpg"> **Disabled** red dot displays beside the name of the Webhook.

**Delete Webhook**

1. Click on the  **Delete** icon beside the name of the Webhook you want to delete.\
   A **Remove User** query box displays, asking you to confirm you want to delete the Webhook.
2. Click the **OK** button. The User is removed from the system.\
   A "Webhook deleted" confirmation message displays under the **Settings** menu.

To ensure a smooth and secure integration with Network International, we kindly request you to whitelist your webhooks. This step is essential for receiving webhook payloads and maintaining uninterrupted service.\
***Sandbox Environment:***\
For testing purposes in the sandbox environment, please reach out to <ecom-integration@network.global.> This will enable you to experiment, validate, and perfect your webhook setup in a controlled environment before going live.\
***Live Environment:***\
When you're ready to transition to the live environment, send your webhook whitelist request to <ecomsupport@network.global.> This ensures that your integration seamlessly connects with Network International's live systems, providing your customers with a reliable and secure experience.