Skip to main content
PUT
Create or update your webhook endpoint

Authorizations

X-API-Key
string
header
required

API key (wg_live_…) created in the dashboard (Account → API Keys). Shown once at creation; only a hash is stored server-side.

Body

application/json
url
string<uri>
required
Example:

"https://yourshop.com/wizzgift/webhook"

events
enum<string>[]

Subset of events to receive; omit for all.

Available options:
payment.detected,
payment.confirmed,
order.completed,
order.partial,
order.failed,
refund.initiated,
refund.completed,
refund.failed

Response

Endpoint saved. secret present only on first create.

id
string
required
Example:

"whe_Ab12Cd34Ef56"

url
string<uri>
required
events
enum<string>[] | null
required
Available options:
payment.detected,
payment.confirmed,
order.completed,
order.partial,
order.failed,
refund.initiated,
refund.completed,
refund.failed
status
enum<string>
required
Available options:
active,
disabled
secret
string

Signing secret (whsec_…) — first create only. Store it now.