Webhooks
Webhooks can be used to receive real-time notifications about events occurring within your store
General guidance
Sellix provides a webhooks system allowing you to subscribe to events with Webhook Endpoints such as Product/Payment Order status webhooks and Dynamic Product webhooks.
A webhook simulator is available allowing you to simulate webhook events to a specified URL.
Create Webhook
Configure your first webhook to receive instant & live notifications about things happening within your Store.
Signing/Validating
To verify the authenticity of a webhook request and its payload, each webhook request includes a X-Sellix-Signature
header with a HMAC signature comprised of the JSON encoded request body and your webhook secret. Your webhook secret can be changed in your settings page.
Signature verification code samples
Events
Each webhook request will feature a X-Sellix-Event
header containing the webhook event type. A list of supported events from Webhook Endpoints can be found below.
Event | Description |
---|---|
order:created | The order has been created. |
order:updated | The order status has changed. |
order:partial | The order status is now partial, indicating a cryptocurrency payment that has been sent but not covering the whole amount. |
order:paid | The order has been flagged as paid, this is the final state. |
order:cancelled | The order has been cancelled either by the fraud shield, the merchant, or due to not receiving a payment within the time window. |
order:disputed | A Stripe/PayPal dispute has been opened against one of your stores. |
product:created | A product has been created. |
product:stock | A product’s stock has fallen below the warning range. |
product:edited | A product has been edited. |
product:dynamic | This event is issued only for dynamic products, to learn more about dynamic products, click here. |
query:created | A query has been created for one of your shops. |
query:replied | A reply has been received for one of your queries. |
feedback:received | One of your customers left a feedback for you. |
subscription:trial:started | A trial has been started for one of your subscriptions. |
subscription:trial:ended | A trial has ended for one of your subscriptions, this is usually followed by an order:created event. |
subscription:created | A subscription has been created, to learn how to better handle subscriptions, please see this guide. |
subscription:updated | A subscription has been updated. |
subscription:renewed | A subscription has been renewed, after receiving a new payment. |
subscription:cancelled | A subscription has been canceled, either due to not receiving a payment or by a manual action of the customer. |
subscription:upcoming | A customer will have to pay for one of your subscriptions in the next 72 hours. |
order:paid:product | This event is the same as order:paid, however the :product segment indicates that it originates from a webhook URL configured within a product, which is now deprecated |
order:partial:product | Similar to order:paid, this event is the same as its parent. |
order:created:product | Similar to order:paid, this event is the same as its parent. |
order:disputed:product | Similar to order:paid, this event is the same as its parent. |
order:cancelled:product | Similar to order:paid, this event is the same as its parent. |
order:updated:product | Similar to order:paid, this event is the same as its parent. |
Logs
Each webhook request will create a Webhook Log. The object is created by the request that has been sent. Before the request’s response has been received, the response_code
will be 0, indicating it is pending.
Whitelist Us
Every request will be sent from 99.81.24.41