Configuration
Add-on settings (Add-ons > Etsy Connector > Settings)
Section titled “Add-on settings (Add-ons > Etsy Connector > Settings)”| Setting | Meaning |
|---|---|
| Enable | Off: no new work starts. Jobs already queued still finish. |
| Marketplace owner mode (Multi-Vendor) | On: one Etsy shop for the marketplace. Off: each vendor connects their own shop. |
| Sync interval (minutes) | How often stock, prices, orders and tracking are processed (default 15). |
| Status of imported orders / Payment method of imported orders | Used for new CS-Cart orders made from Etsy receipts. |
| Debug log | Also logs every HTTP call (masked). Switch off when done. |
| Log retention (days) | Older log rows are deleted. |
| Permanently delete Etsy order and listing links on uninstall | Off (default): uninstall keeps the links, the connection and the settings. On: the next uninstall deletes them. |
| Cron | The console command and the secret web address of the job queue. |
Connection page
Section titled “Connection page”| Field | Meaning |
|---|---|
| Callback URL | Register exactly this https URL in your Etsy app. |
| Keystring (API key) / Shared secret | From “Your apps” on etsy.com/developers. Sent in every request as x-api-key. Stored encrypted; an empty field keeps the stored value. |
| Webhook signing secret | Optional, from Etsy’s webhook portal (whsec_...). |
| Connect Etsy shop / Connect again / Disconnect | Etsy sign-in (OAuth 2.0 with PKCE). Tokens renew automatically; after 90 days without use, connect again. |
| Shipping profile | Required for physical listings. |
| Return policy, Processing profile | Optional defaults for new listings. |
| Who made it, When was it made, Supply | Etsy’s required listing facts. |
| Publish new listings | Off (default) = drafts. Etsy charges its listing fee on publishing. |
| Import orders from | Optional day (shop time zone); receipts placed earlier are skipped. Empty = the last 7 days at the first run. |
If Etsy rejects the stored authorization (revoked app, expired access), the page shows “Syncing is paused” and the add-on makes no further calls until you click Connect again.
Rules tab
Section titled “Rules tab”Price markup (percent and fixed amount), price endings, exchange rate (Etsy shop currency per store currency), stock buffer, “show zero at or below”, maximum stock sent, automatic listing creation, guest or matched customers, and the mapping of Etsy receipt states (paid, shipped, cancelled, fully refunded) to CS-Cart order statuses.
Categories and Attributes tabs
Section titled “Categories and Attributes tabs”Map each CS-Cart category to an Etsy category (seller taxonomy); the deepest mapped category of a product wins and its markup applies. On the Attributes tab, map Etsy properties (colour, material …) to CS-Cart product features or fixed values.