ce-webhooks

Verify signatures and route Commerce Engine webhook events by type.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/tark-ai/ce-starter-projects --skill ce-webhooks-tark-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ce-webhooks
Source: https://github.com/tark-ai/ce-starter-projects/tree/main/.agents/skills/ce-webhooks
Command: npx skills add https://github.com/tark-ai/ce-starter-projects --skill ce-webhooks-tark-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Commerce Engine webhook events require secure, reliable handling and routing to power async workflows. This Skill provides signature verification, routing by event type, and robust processing patterns to keep systems in sync.

Core Features & Use Cases

  • Asynchronous event processing: receive, verify signatures, route events by type (order, payment, refund, shipment) and enqueue heavy work.
  • Reliability patterns: ensure idempotent handling, retries, and quick 200 responses to webhook publishers.
  • Use Case: Integrate with your backend to automatically sync order data and trigger downstream workflows when events occur.

Quick Start

Set up a webhook endpoint that receives events at /webhooks/ce, verifies the signature, and queues processing tasks for asynchronous work.

Frequently Asked Questions about ce-webhooks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify webhook signatures for Commerce Engine events?

Webhook signature verification for Commerce Engine events is handled automatically by this Skill, validating incoming payloads before any processing occurs. It routes verified events by type and returns a quick 200 acknowledgement to the publisher.

What's the best way to handle asynchronous processing for order and payment webhooks?

Asynchronous processing for order and payment webhooks is managed by routing events to background processing queues. This ensures heavy work runs separately, allowing the endpoint to immediately return a 200 response and maintain system reliability.

How do I route Commerce Engine webhook events by type for refunds and shipments?

Routing Commerce Engine webhook events by type, including refunds and shipments, is performed automatically after signature verification. The Skill identifies the event category and directs it to the appropriate downstream workflow or processing queue.

Can I use this for idempotent webhook handling and retries on event delivery failures?

Idempotent webhook handling and retries for event delivery failures are supported through built-in reliability patterns. This ensures duplicate events do not cause duplicate actions and transient failures are retried without losing sync.

Do I need a background queue to process Commerce Engine webhooks reliably?

A background queue is required to process Commerce Engine webhooks reliably, as the Skill enqueues heavy asynchronous tasks after verifying signatures. This allows the endpoint to return a 200 response quickly while processing completes separately.