Description
Integrates your WooCommerce store with doTERRA‘s hosted checkout service. WooCommerce continues to run your catalog, product pages, and cart. At checkout, this connector builds a secure doTERRA checkout URL from your settings and the current cart, then routes the customer to that service with every line included and your Wellness Advocate ID attached.
doTERRA’s service provides payment, shipping, tax calculation, and fulfillment for those checkouts. Review doTERRA’s own terms of use and policies before you use it.
WooCommerce 8.0 or newer must be installed and active. The plugin works with any theme.
Checkout connection
- Builds the checkout URL from the Advocate ID, market, and related values you enter in WooCommerce > Settings > doTERRA. Those values are never hardcoded, so more than one advocate can use the plugin.
- Prefills the United States (
US/en, Sales OrgUSOTG) and Canada (CA/en, Sales OrgCAOTG). For any other market, choose Other market and copy the market path, Sales Org, account type, and referral parameter from your own doTERRA referral link. - Merges duplicate cart lines of the same product so quantities are added together.
- Blocks the connection instead of sending a broken cart. If a product has no doTERRA product ID, or if that ID would overwrite a reserved checkout parameter (
OwnerID,salesOrg, oracctType), the customer sees an explanation and nothing is sent. - Warns you in the admin when a published product is missing a doTERRA product ID.
WooCommerce storefront adjustments
- Hides sale badges. Local list prices are not the totals doTERRA’s checkout service will charge.
- Notes on the cart total that shipping and tax are calculated by doTERRA’s checkout service, and hides the block-cart totals wrapper that would otherwise show local shipping estimates.
- On activation, turns off WooCommerce coupons, product reviews, and customer self-registration at checkout and on My Account. You can turn any of those back on in WooCommerce settings. Existing local users can still sign in.
- Shortens the cart session to two hours (expiring) and three hours (expired).
Integrations
- Product Sync (optional, paid): keeps your products in step with doTERRA’s catalog for your market. Subscribe and connect from the connector’s settings tab; your store grants access on WooCommerce’s own approval screen, so you never create or copy a key. See External services below.
- Product import with another importer: Product Sync doesn’t need this. For your own importer, create keys under WooCommerce > Settings > Advanced > REST API. Use a Shop Manager or Administrator user with Read/Write for catalogue import (or Read for the connector’s market-path endpoint only). Copy the consumer key and secret into your importer. Use HTTPS. The connector settings screen links to that WooCommerce screen.
- Read-only market path:
GET /wp-json/wc-zccd/v1/settingsreturns{ "market_path": "US/en" }(or whatever market your store connects to). Authenticate with a WooCommerce REST API key whose user can manage WooCommerce. The route cannot change settings.
What it does not do
- It does not call doTERRA’s servers with a background API. It builds an https
www.doterra.comcheckout URL and routes the customer’s browser there. - It does not send telemetry, analytics, or other traffic to the plugin author.
- It does not process payment or store customer personal data for the connected checkout. It reads the cart the customer already has in WooCommerce and builds the service URL.
Privacy
The plugin sends no data to the plugin author. If you subscribe to the optional Product Sync service and connect your store to it, the service receives what External services below describes. At checkout, the customer’s browser is routed to doTERRA’s checkout service with product identifiers, quantities, and your Advocate ID in the URL. doTERRA then completes payment and fulfillment under its own terms and privacy policy.
Independence
This plugin is an independent tool. It is not affiliated with, endorsed by, or sponsored by doTERRA. “doTERRA” is used only to identify the checkout service the connector works with.
External services
The connector itself contacts no outside server for Product Sync. Its settings tab shows static links; whether your store is connected is read from WooCommerce’s own record of the key it issued.
Product Sync is an optional paid subscription run by Apollo Software LLC at https://sync.apollosoftwarellc.com. Nothing is sent to it until you connect your store there. When you approve access on WooCommerce’s approval screen:
- the service receives a read/write WooCommerce REST API key for your store, and stores it with your store address, your market and your license key;
- on each sync it reads your market path from the connector and creates, updates and hides products in your store from doTERRA’s catalog for that market. Products without a code are left alone and nothing is deleted;
- your license key is checked with Lemon Squeezy, the store that sells the subscription.
You can disconnect on the service’s status page and revoke the key under WooCommerce > Settings > Advanced > REST API at any time. Terms: https://sync.apollosoftwarellc.com/terms. Privacy policy: https://sync.apollosoftwarellc.com/privacy.
Installation
- Make sure WooCommerce 8.0 or newer is installed and active.
- Go to Plugins > Add Plugin, search for Zoryna Checkout Connector, click Install Now, then Activate.
- Go to WooCommerce > Settings > doTERRA. Enter your Advocate ID, choose your market, and click Save changes. The United States and Canada fill in the remaining fields. For any other market, choose Other market and copy the values from your own doTERRA referral link.
- Put each product’s doTERRA product ID in that product’s SKU field. A notice names any published product that is missing one.
- Test: add two products to your cart and go to checkout. You should land on
www.doterra.comwith both products in the cart and your Advocate ID in the address.
If WooCommerce is missing or too old, the plugin shows an admin notice and does not hand off checkout.
FAQ
Where does the customer pay?
Through doTERRA’s hosted checkout service. This connector builds the checkout URL from your WooCommerce cart and settings and routes the customer there. You do not need a separate local payment gateway for those checkouts.
Where do I find my Advocate ID?
In your doTERRA back office, or in your own referral link — it is the number after OwnerID=.
Which markets are supported?
Any market. The United States (US/en, Sales Org USOTG) and Canada (CA/en, Sales Org CAOTG) come prefilled from working production checkout links. For anything else, choose Other market and enter the market path, Sales Org, account type, and referral parameter from your own doTERRA referral link.
Why are some fields greyed out?
A listed market owns those values. Overwriting them would produce the wrong checkout address. Choose Other market to enter them yourself.
Where does the referral parameter come from?
From the advocate link observed for that market: 60219088=1 for the United States, 60218439=1 for Canada. If doTERRA has given you a different pair, choose Other market and enter it. Leave both boxes empty to send no referral parameter.
What happens if a product has no SKU?
Checkout stops and the customer is shown a message naming the product. An admin notice also names published products that are missing a doTERRA product ID.
A product’s SKU matches OwnerID, salesOrg, or acctType. What then?
The handoff is blocked. That collision would overwrite a checkout parameter and misattribute the order. Give the product its real doTERRA product ID.
Does it work with my theme?
Yes. Sale-badge hiding, the shipping note, and the checkout redirect do not depend on a particular theme.
Is there a companion theme?
Yes, optional and sold separately: Zoryna Storefront for doTERRA, a Kadence child theme with a ready-made homepage, About and FAQ pages, and editable disclaimer pages. The connector settings screen links to it while it is not installed. Every connector feature works without it, and the link is static: showing it contacts no server.
What is Product Sync?
An optional paid subscription that keeps your products in step with doTERRA’s catalog for your market: it adds new products, updates prices, descriptions and images, and hides products whose code is no longer in the catalog. Subscribe and connect from WooCommerce > Settings > doTERRA. Your store must use HTTPS. Cancelling stops syncing at the end of the paid period; the products already in your store stay as they are. The connector works the same without it.
How do I give a product importer API access?
Product Sync doesn’t need this: it asks for access through WooCommerce’s own approval screen. For another importer, create a WooCommerce REST API key under WooCommerce > Settings > Advanced > REST API. Choose a Shop Manager or Administrator, set Read/Write for catalogue import (or Read for the market-path endpoint only), generate the key, and copy the consumer key and secret into your importer over HTTPS. The connector settings screen links to that WooCommerce page. Delete keys you no longer need from the same list.
Can another system read my connector settings?
It can read one value: the market path, at GET /wp-json/wc-zccd/v1/settings, using a WooCommerce REST API key (Read is enough) whose user can manage WooCommerce. On plain permalinks use /?rest_route=/wc-zccd/v1/settings. Nothing else is exposed, and nothing can be changed through this route.
Can a developer change how the doTERRA product ID is resolved?
Yes. zccd_product_external_id filters the identifier (SKU by default). zccd_redirect_url filters the finished https www.doterra.com URL; any other host blocks the handoff. zccd_before_redirect fires immediately before the redirect — handlers must not print output.
What is removed when I uninstall?
The connector settings option and the cached product-scan result. WooCommerce REST API keys you created for an importer, and the Zoryna Product Sync key, are not removed; delete those under WooCommerce > Settings > Advanced > REST API if you no longer need them.
Changelog
1.5.0
- Optional Product Sync section on the settings tab: subscribe, and connect your store through WooCommerce’s own approval screen. The section is static links; the connector contacts no outside server for it.
- WooCommerce’s API-key approval screen now works on sites using Plain permalinks. WooCommerce built its approve and login links in a form its own handler does not read there.
- The REST API key help is now headed “Using another importer”.
1.4.1
- Declares compatibility with WooCommerce High-Performance Order Storage and the cart and checkout blocks, so WooCommerce no longer flags the plugin as incompatible.
- No connector behavior changes.
1.4.0
- The settings screen mentions the optional companion theme while it is not installed. The mention is a static link; nothing is fetched to show it.
- Plugin and theme versions are now independent. No connector behavior changes.
- Tested with WordPress 7.1.3 and WooCommerce 11.2.1.
1.3.0
- Companion theme states that it does not redirect checkout; this plugin is required for that.
- No connector behavior changes. Version stays aligned with the theme.
1.2.0
- Companion theme is now Zoryna Storefront for doTERRA (
zoryna-storefront-doterra). - No connector behavior changes. Version stays aligned with the theme.
1.1.0
- Renames the plugin to Zoryna Checkout Connector for doTERRA (slug
zoryna-checkout-connector-doterra) with thezccd_prefix. - Removes in-plugin Store management API key provisioning; documents native WooCommerce REST API keys for product import instead.
- Limits connector admin notices to WooCommerce and product screens.
1.0.27
- Reframes readme and settings copy around connecting WooCommerce to doTERRA’s hosted checkout service.
1.0.26
- Raises Tested up to WordPress 7.1 and drops the manual textdomain load for WordPress.org hosting.
1.0.25
- Maintenance release.
1.0.24
- Maintenance release.
1.0.23
- Updates the plugin readme for the WordPress Plugin Directory.
1.0.22
- Maintenance release.
1.0.21
- Maintenance release.
1.0.20
- Maintenance release.
1.0.19
- Maintenance release.
1.0.18
- Maintenance release.
1.0.17
- Keeps management API access inside the WooCommerce settings content area, below Save changes, with spacing so it does not overlap the footer.
1.0.16
- Places API access below the settings form and its Save changes button, shows only the Store URL, and aligns Copy buttons beside their fields.
1.0.15
- Adds administrator-controlled product import access on the doTERRA settings page, with a dedicated Shop Manager account, one-time API credentials, a copyable store URL, and regeneration and revocation controls.
1.0.14
- Maintenance release.
1.0.13
- Maintenance release.
1.0.12
- Maintenance release.
1.0.11
- Disables WooCommerce product reviews and customer self-registration at checkout and on My Account when the plugin is activated.
1.0.10
- Maintenance release.
1.0.9
- Maintenance release.
1.0.8
- Hides the generated totals wrapper that owns the shipping section’s border and padding, removing the orphaned double divider above the cart total.
1.0.7
- Hides the named block-cart and block-checkout shipping containers.
1.0.6
- Hides local shipping estimates from the block cart because shipping is calculated at doTERRA checkout.
1.0.5
- Maintenance release.
1.0.4
- Disables WooCommerce coupons on activation so the local cart does not offer discounts that disappear at doTERRA checkout.
1.0.3
- Maintenance release.
1.0.2
- Maintenance release.
1.0.1
- Adds a read-only REST endpoint that returns the market path the store hands off to.
1.0.0
- First release.
