whatalo webhook trigger
Send a test webhook event to your plugin during local development — no real orders or customers required.
Syntax
whatalo webhook trigger [event] [options]Options
| Flag | Type | Description |
|---|---|---|
--store <id> | string | Target dev store to use as event origin |
--list | boolean | Print all available events and exit |
--payload <file> | string | Path to a custom JSON payload file |
--json | boolean | Output result as JSON |
--portal-url <url> | string | Developer Portal URL |
Available Events
Run whatalo webhook trigger --list to see all events.
| Category | Event |
|---|---|
| Orders | ORDER_CREATED |
| Orders | ORDER_UPDATED |
| Orders | ORDER_CANCELLED |
| Products | PRODUCT_CREATED |
| Products | PRODUCT_UPDATED |
| Products | PRODUCT_DELETED |
| Customers | CUSTOMER_CREATED |
| Customers | CUSTOMER_UPDATED |
| Checkout | CHECKOUT_COMPLETED |
Security
whatalo webhook trigger only works against development stores. Attempting to trigger a webhook against a production store returns a 403 error. This restriction is enforced server-side.
Delivery Details
The webhook is delivered to your plugin's configured endpoint:
| Property | Value |
|---|---|
| Target URL | manifest.webhookUrl or active dev session tunnel URL |
| Timeout | 15 seconds |
| Header: Signature | X-Webhook-Signature (HMAC-SHA256) |
| Header: Event | X-Webhook-Event |
| Header: ID | X-Webhook-ID |
The signature uses the same algorithm as real webhooks. Your src/webhooks/verify.ts file (scaffolded by whatalo init) handles verification including replay protection.
Examples
List all available events:
whatalo webhook trigger --listTrigger a test order creation:
whatalo webhook trigger ORDER_CREATEDTrigger with a specific dev store:
whatalo webhook trigger ORDER_CREATED --store my-dev-storeTrigger with a custom payload from a file:
whatalo webhook trigger ORDER_CREATED --payload ./test-payloads/big-order.jsonTrigger and capture the result as JSON:
whatalo webhook trigger CHECKOUT_COMPLETED --jsonCustom Payloads
By default, the CLI sends a realistic sample payload for each event type. To override it, create a JSON file with the desired structure and pass it with --payload:
{
"id": "819365047283",
"total": "199.99",
"currency": "DOP",
"status": "confirmed",
"customer": {
"name": "María García",
"email": "[email protected]"
}
}whatalo webhook trigger ORDER_CREATED --payload ./my-payload.jsonRelated Commands
whatalo logs— View webhook delivery logswhatalo dev— Start local development (required before triggering)