Introduction

This functionality allows merchant online store system to receive payment updates in the background instantly when the payment status changes and react on them automatically (order is updated). The online store gets the notification when it happens regardless the presence of the customer in the payment flow. In other words the merchant is getting the information about the payment even if the customer leaves the payment flow. For example, in case the customer finishes authorization of the payment in his bank successfully but then just closes the browser (or turns off the phone screen) normally the order in the online store stays in opened state and merchant would need to investigate the payment status. When webhooks functionality is used the online store will get the update in the background and plugin automatically moves the order to correct state.

Configuration

Webhook URL

Webhook URL which is then called by Everifin Paygate server is present in the plugin configuration. It should be copied from there and used in webhook configuration in Everifin Paygate Back Office. How to configure webhook in Back Office is described here:
Webhook Definition | Defining webhooks

Webhook Secret

The communication between Everifin server and the online store needs to be secured. To ensure the security, we use combination of:

• message signatures, with timestamp included - Webhook Secret is used to sign the messages

• HTTPS protocol - only https url can be configured as webhook URL

The secret needs to be generated in Everifin Paygate Back Office as described here: Webhooks Security | Hook secrets

After the generation, the secret value needs to be copied and placed in e-shop admin environment on the plugin configuration page into the field “Webhook secret” (more details can be found on sub-page dedicated to specific plugin).

Finally the configuration needs to be saved.