Testing and receiver handling

Quick test with a disposable HTTPS endpoint API=https://core-api.zencommerce.tech/v1/developer URL=https://webhook.site/YOUR-UUID # 1) Register curl -sS -X POST "$API/register" -H 'Content-Type: application/json' \ -d '{"email":"you@example.com","name":"Test Dev"}' # Save api_key and api_secret from…

Signature verification

Every webhook request is signed so you can confirm it came from Zencommerce and was not altered. The signature is in X-Webhook-Signature. Values you need Variable Source $webhookSecret Returned once…

Delivery format and headers

Zencommerce delivers webhooks as HTTP POST requests. The body is JSON: POST /webhooks/zencommerce HTTP/1.1 Host: your-app.example.com Content-Type: application/json X-Shop-Domain: mystore.example.com X-Shop-Hash: 9f2c… X-Webhook-Id: 42 X-Webhook-Event: order.create X-Webhook-Signature: e3b0… { "event":…

Supported events

GET /v1/developer/webhooks/events Event Description Categories (collections) category.create A new category (collection) was created category.edit An existing category was modified category.delete A category was deleted Orders order.create A new order was…

Subscription API

The store must have webhooks enabled. Any registered developer may subscribe to any enabled store by handle (not only stores they own). You only see and manage your own subscriptions.…

Developer registration and authentication

Register POST /v1/developer/register Content-Type: application/json { "email": "dev@example.com", "name": "Acme Integrations", "password": "optional-min-8-chars" } Response (201) — api_secret is returned once: { "developer": { "id": 1, "email": "dev@example.com", "name": "Acme…

Merchant setup

Steps to set up Merchant Open Settings → Integrations → Webhooks. Turn Enable webhooks on and save. Note the store handle (for example, mystore). When webhooks are disabled: Deliveries for…

Webhook Overview

Webhook Overview Webhooks let your application receive real-time notifications when events occur in a Zencommerce store. Instead of polling the API, you register an HTTPS URL; Zencommerce sends an HTTP…