Webhooks
The Webhooks configuration section allows you to set up and manage webhook listeners that receive real‑time notifications for events occurring in the Merchant Portal and the Payment Orchestration Platform.
Webhooks are accessible by navigating to Administration → Webhooks. By selecting the desired entity in the account tree, the list of webhook listeners currently configured for that entity is displayed.
Figure 1: Admin – Webhooks overview
Where to find this screen
- In the left navigation menu, select Admin.
- Select Webhooks.
Webhooks List
The Webhooks list displays all webhook listeners configured for the selected entity. Each row represents a listener and provides an overview of where notifications are sent and which event types are delivered.
The following information is provided for each listener:
- URL – The endpoint URL of the listener.
- Notification Type – The notification categories configured for the listener (for example, Payments, Risks, Registrations, or Schedules).
- Fields – The type of fields included in the notification payload.
- State – The current state of the listener (active or inactive).
- Test – Allows sending a test notification to the listener.
- Enablement – Displays the available activation or deactivation action.
- Actions – Edit and delete options for the webhook listener.
Additional features available directly from the webhook list include Copy to Clipboard, which copies the full list of configured webhooks, and Export to CSV, which downloads the list as a file.
View Webhooks List
To view webhook listeners, navigate to Administration → Webhooks and select the desired entity in the account tree.
Each entry in the table displays the listener URL, notification type, field configuration, current state, and available actions.
Add New Webhook
To add a new webhook listener, select Add. A configuration form opens in a pop‑up dialog.
The following fields must be configured:
- URL – The endpoint URL that will receive webhook notifications.
- Notification Type – Select the categories of notifications the listener should receive. Available categories are Payment, Registrations, Schedules, and Risk. Individual notification types can be selected by typing the name and choosing from the list, or all notification types can be enabled at once using Select All.
-
Fields – Specify which fields to include in the notification payload:
- All Fields – Includes all available data fields.
- No Customer Data – Excludes customer data from the payload.
- Wrapper – Select the encryption wrapper for the notification payload. Available options are No Wrapper and JSON Wrapper.
- Secret – An auto‑generated value used to decrypt notifications on the listener side. Refer to the Integration Guide for details on how to use this value.
- Alert Email Addresses – Optionally specify one or more email addresses to be notified if webhook retries fail and the listener does not respond correctly.
Select Add to save the configuration and create the new webhook listener.
ℹ️ Note: Newly created webhook listeners are set to Inactive by default. The listener must be activated before it starts receiving notifications.
Test Webhook
To send a test notification to a listener, select Test on the corresponding row in the webhook list.
A test notification is sent to the configured listener URL, and the headers returned by the listener are displayed in a response dialog. This allows you to verify that the listener is reachable and responding correctly before activating it.
Activate and Deactivate Webhook
To activate a webhook listener, select Activate in the enablement column of the corresponding row.
As part of the activation process, a test notification is sent to the listener. If the listener responds successfully, the webhook is activated and begins receiving notifications. The returned headers are displayed for verification.
To deactivate an active webhook listener, select Deactivate. The listener stops receiving notifications until it is reactivated.
Edit Webhook
To edit an existing webhook listener, select Edit from the action menu on the right of the corresponding row.
The configuration dialog opens pre‑filled with the current settings. Update the required fields and select Save to apply the changes.
Delete Webhook
To delete a webhook listener, select Delete from the action menu on the right of the corresponding row.
⚠️ Warning: Deleting a webhook stops all notifications to the configured endpoint and may impact downstream systems that rely on these events.
Summary
The Admin → Webhooks section provides a centralized way to configure and manage real‑time event notifications. By using webhook listeners, merchants and PSPs can integrate payment, risk, registration, and scheduling events into their own systems, supporting automation, monitoring, and near real‑time processing.