Merchize Webhooks Guide

< All Topics

Adding Webhook integration to get real-time updates, get notified when a specific event occurs, creating an automated workflow, and more.

 

Get your POST URL from webhook service provider or your own webhook server

This example uses Webhook.site is an open-source and free service that generates a unique URL for you to receive webhooks without having to set up and maintain your own infrastructure. 

When you arrive at Webhook.site,  you’ll see a unique webhook URL you can use to receive webhooks.

Copy the URL displayed under Your unique URL.

 

Set up the webhook output in Merchize

Return to your Merchize dashboard.

Click Setting in the left nav bar, then click “Webhook”. 

 

1. Create Secret Key

First, you have to create secret key.
Click “Add Secret Key”.

The system will generate a new secret key. This key serves as an essential component in verifying the authenticity and integrity of the event, thus contributing to the overall security and reliability of the process.

 

2. Configure the Webhook

  • Click Add Webhook.

  • In the modal that appears, add data to these fields.

Field Setting
Endpoint Paste the unique URL you copied from webhook.site
Events Select the one or multiple events you want to be notified about:

ORDER.CREATED

ORDER.PAYMENT.REFUND

ORDER.CHANGED.TRACKING

ORDER.CHANGED.SHIPMENT

ORDER.PAYMENT.TRANSACTION_FEE

ORDER.PAYMENT.FULFILLMENT_COST

ORDER.PAYMENT.SURCHARGE

ORDER.CHANGED.PROGRESS

ORDER.PAYMENT.FULFILLMENT_COST_PAID

ORDER.CHANGED.PROGRESS_STATUS

 

When finished, click Add. The created webhooks will be shown under the “Webhooks" section, you can toggle the webhook to be Active/Unactive or Delete the webhook.

 

Test Webhook requests

On the top right-hand corner of the webhook screen shown above, click More actionWebhook simulator. This will open a screen for you to enter the Webhook URL & select the event for which you want to send the test.

Then you’ll see a success message, along with the data sent to your webhook.

 

Check the response on Webhook.site

All webhooks sent to the webhook URL will be listed on the left panel. This allows you to switch between the requests and inspect their results quickly.

The right panel shows the webhook notification in JSON format.

 

Monitor the Webhook logs

To track the delivery and performance of the custom alert notifications, click on the More Action button > choose Webhook notification.

When a webhook is triggered, the information about each delivery or attempted delivery is listed in the “Webhook notification“. Each time the webhook is triggered an entry will be added to the list.

The workspace controls also allow you to use filters to find data that shows for your delivered notifications.

 

View, retry, or delete notification Webhooks

To view a request sent, click the icon   

To remove an event, click the icon (when it’s in Pending status)

To retry a failed/canceled event, click the icon

 

 

Webhook events and payloads

For details of the supported webhook events, how they are triggered and the payload for each webhook event, go to the webhook payloads page.

A “payload" containing information that the webhook handler will process.

Related articles