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 Org
CAOTG). 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 import via WooCommerce REST API: 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":(or whatever market your store connects to). Authenticate with a WooCommerce
"US/en" }
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.com checkout 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
No data is sent to the plugin author. 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.
Installation
- Install and activate WooCommerce 8.0 or newer if it is not already active.
- Upload the plugin folder to
/wp-content/plugins/, or install the zip through
Plugins > Add New > Upload Plugin. - Activate Zoryna Checkout Connector for doTERRA.
- Go to WooCommerce > Settings > doTERRA.
- Enter your Advocate ID and choose your market. Listed markets fill in the remaining
fields. If your market is not listed, 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.
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 OrgUSOTG) 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=1for 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. -
How do I give a product importer API access?
-
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_idfilters the identifier (SKU by default).zccd_redirect_url
filters the finished httpswww.doterra.comURL; 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 are not removed; delete those under WooCommerce >
Settings > Advanced > REST API if you no longer need them.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Zoryna Checkout Connector for doTERRA” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Zoryna Checkout Connector for doTERRA” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
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.