Webhooks

Enable and configure webhooks to get notified about events in the system.

The Webhooks section allows you to manage available webhooks that you can connect to other systems you use in your company.

Webhooks is a convenient tool that allows you to subscribe to certain events that are happening in the Emporix Commerce Engine to get instant information about them. For example, you might want to subscribe to all instances when an order is created in the system and send a message about it to your external order management application for further processing.

Configuring webhook service

To receive notifications about events happening in the system, firstly configure the webhook service according to your needs. To choose the relevant strategy, follow these steps:

  1. Go to Administration -> Webhooks.

  2. Select one of the available strategies.

  3. Depending on the selected option, you might be asked to provide more details to enable the notifications. Confirm with Active.

Webhook strategies

Emporix offers the following strategies you can choose for the webhook event gateway:

You can have only one strategy active at a time.

Shared account - SVIX strategy

The default solution to handle webhook events that comes with Commerce Engine is Svix-shared strategy. You can use this strategy out-of-the-box up to the set monthly limit.

Svix Dashboard

With Svix-shared webhook strategy, you get access to Svix dashboard. This is the place to connect the webhooks to specific endpoints.

  1. In Administration -> Webhooks, choose Open Svix Dashboard. You're redirected to Svix.

  2. Go to Endpoints and choose Add endpoint.

    • In Endpoint URL, provide a URL of the system you want to connect the webhooks to.

    • Choose the event types of your interest and choose Create to start receiving notifications.

Now, in Svix Dashboard, you can see all the events of the types that you have subscribed to. You are able to check the payload details of each particular event message sent to the external system. You can also check the schema of a particular event type under the Event catalog.

Viewing your webhook usage

You can keep the webhooks usage under control by checking the usage statistics.

In Administration -> Webhooks, you can see your current monthly usage. By choosing the Webhook usage, you get a detailed overview of the webhooks usage in a particular period.

Licensed account - SVIX strategy

Choose the Svix strategy if you need more flexibility and want to connect your independent Svix subscription to Commerce Engine system. To activate this strategy, provide an API key that you get directly from Svix. With the Svix strategy, the monthly webhook traffic limit depends on your own Svix plan.

Other - HTTP strategy

This strategy allows you to receive webhook events notifications directly to the provided URL. When selecting this webhook strategy, provide a destination URL to consume the requests.

Optionally, you can secure HTTP communication with HMAC secret. The HMAC (keyed-Hash Message Authentication Code) security layer verifies if the checksum of data that came to the destination point is correct. HMAC is a type of authentication technique that uses a hash function and a secret key. You can use it to sign a request with a shared secret.

For more information on how to secure the requests with HMAC encryption, see HTTP Webhook Strategy - HMAC Configuration.

With Custom Headers, you can define a list of headers which are attached to the API request sent through the webhooks. For example, use custom headers to provide the following:

  • authentication and authorization measures: API keys, bearer tokens, or other security tokens

  • context information: some additional information about the context of a request, for example the request origin, the response preferred language, or user-defined preferences

Moreover, each HTTP request has emporix-event-publish-time header attached which contains timestamp in RFC3339 UTC "Zulu" format and provides information about the time at which the message was published. As an addition to the main destination URL, you can define more destination URLs to receive webhook notifications for particular events.

To define event-specific destination URL, select the event from the list and choose Edit icon:

Subscribing to webhook events

Apart from choosing the webhook strategy that is right for you, decide which specific events you'd like to listen to.

  1. In Administration -> Webhooks, expand the service of your interest to see the list of available events. Turn on the slide under Status column to switch the webhook on.

  2. Go to edit mode by choosing the Edit icon.

  1. Select the attributes you'd like to see in the webhook payload message. Confirm with Update subscription.

productid
price with associated sites
number of emitted events
sites the event was emitted to

123

$10 - site A, B

2

A, B

234

$10 - site A, $15- siteA, B, C`

3

A, B, C

345

no price

0

none

Last updated

Was this helpful?