Prerequisites

Before you start using webhooks, ensure you meet the following prerequisites:

Technical requirements

• Create a publicly accessible HTTPS endpoint that can receive and process webhook payloads.

• Implement proper security measures to validate webhook signatures. (Applicable to Transaction Webhooks only)

• Set up an appropriate error handling and retry logic.

Webhook configuration

Register your Webhook URL with our integration team for configuration. Webhook URLs will be configured on the merchant account to receive POST events.

The accessible HTTPs POST endpoint is prepared to:

• Accept incoming HTTP POST requests.

• Respond with an HTTP 200 OK status code to acknowledge successful receipt.

Webhook configuration by user type

You can manage registered webhooks according to your need.

Software Partners

The webhook configuration applies during the account setup.

The setup process differs depending on the webhook type.

Virtual Terminal Users

Users with an Account Administrator role can only configure webhooks in the Virtual Terminal.

To add a webhook URL in the Merchant Portal:

1. Go to VT Settings > Terminal.

2. Select the Enable Transaction Alert.

3. Add your URL to the Transaction Alert Callback URL field.

4. Click Save Terminal Settings.

For more information about Virtual Terminal, see Virtual Terminal.