WooCommerce

Overview of Violet's WooCommerce integration for channel developers

WooCommerce is a WordPress-based ecommerce plugin used by millions of online stores. Merchants connect to Violet using REST API keys generated from their WordPress admin.

Connection

Merchants provide a Consumer Key, Consumer Secret, and their Store URL. These are generated in the WooCommerce admin under WooCommerce → Settings → Advanced → REST API.

Permalink Requirement

WooCommerce's REST API requires the Post name permalink structure to function correctly. Merchants using the default WordPress permalink structure (/?p=123) will encounter 404 errors. Merchants should confirm this setting under Settings → Permalinks in WordPress.

Webhooks

Webhooks are registered and managed automatically by Violet. The following topics are used:

Topic	Purpose
product.created	New product published
product.updated	Product changes synced
product.deleted	Product removed from catalog
order.updated	Order status or fulfillment updated
order.deleted	Order removed

Webhooks are named using the pattern violet_{topic}_{environment} to distinguish Violet's webhooks from others and to avoid accidental deletion.

Notable Behavior

• Product types: WooCommerce has simple, variable, grouped, external, virtual, and downloadable product types. Violet syncs simple and variable products. Variable products use WooCommerce's variation system, which Violet maps to its unified variant model.

• Discount codes: WooCommerce coupon codes are supported. Violet distributes discount amounts at the line-item level and creates a coupon line in the submitted order.

• Tax: WooCommerce's tax configuration can be complex. Tax calculation behavior depends on the merchant's store settings.