Before you start
- Your store is served over HTTPS.
- WooCommerce is 3.5 or later. With 5.8 or later, Tranthor can also fetch updates it missed while your store was unreachable.
- Pretty permalinks are on (WordPress Settings, Permalinks), so the WordPress REST API answers at
/wp-json/. - You are an organization owner or admin in Tranthor, and can approve apps in your WordPress admin.
Connect a store
- In Tranthor, go to Settings, Integrations. Under Store data, select Connect on the WooCommerce card.
- Enter your Store address, for example
https://shop.example.com, and select Check store. - Tranthor checks the store. When every check passes, select Connect WooCommerce.
- Your WordPress admin opens. Approve Tranthor, and you come straight back.
If a check fails
A store that cannot pass these checks cannot be connected yet.
Import your history
After you approve, Tranthor imports the store’s history: customers, then products, then orders with their refunds. The most recent 90 days come first, then everything older.- Imported events never start journeys, so nobody gets a welcome or an order message for something that happened last year.
- Journeys that people enter through a segment are paused while the import runs, and the page lists them. People already in them resume when the import finishes. A large store can take hours.
- If the store has more registered customers than your plan has contacts left, Tranthor asks first. You can Upgrade plan, Import the most recent customers that fit, or Import all.
What Tranthor receives
After the import, the store sends changes to Tranthor as they happen: new and changed orders, products and customers.Events
Order events carry the order’s id and number, status, currency, total, discount, shipping and tax totals, coupons, line items and payment method.
Ordered Product also carries the product’s id, name, SKU, categories, quantity and price.
Customer properties
email, phone (the billing phone), firstName, lastName and address (billing and shipping).
Not included
Carts, checkouts and product views do not come from this connection. Send those from your storefront with the Web SDK or the CLI Wizard.How customers are matched
Tranthor matches a WooCommerce customer to a person it already knows by email. A guest order with an email is matched the same way. A customer with no match becomes a new person. If you keep your own customer id in WooCommerce, enter the customer meta key that holds it under Customers, Brand ID customer field, for examplecrm_id. Tranthor then uses that id as the person’s id. It applies to new customers, and keys that start with _ are not supported.
Marketing consent
Under Customers, Marketing email consent decides whether new shoppers are subscribed to marketing email:- Not subscribed until they opt in (the default). Nobody from the store is subscribed until they opt in some other way.
- Read consent from a customer field. Enter the customer meta key your store saves consent in, for example
newsletter, and the values that mean subscribed (by defaultyes,true,1,subscribed).
Status and health
The WooCommerce card shows each store with its status (Connected, Finishing setup, Needs attention or Disconnected), when it last synced and its health.
Tranthor checks every hour and recreates a webhook that is missing or disabled. Once a day it compares the orders your store changed with the ones it received, and fetches any it missed. Problems also show in Needs you.
Disconnect a store
Select Disconnect on the store. Your data stays in Tranthor. Any running import stops, and new orders and customers stop arriving until you reconnect. Afterwards, revoke Tranthor’s key in your WordPress admin under WooCommerce, Settings, Advanced, REST API. If you reconnect within 7 days, Tranthor fetches what changed while the store was disconnected. After longer, it imports the history again.Delete a store’s data
After disconnecting, Delete store data removes every event from that store, and the people who came only from that store, with their messages. People who also came from somewhere else keep their profile and their other data. You type the store’s address to confirm. It cannot be undone.Current limits
- Carts, checkouts and product views are not synced.
- Deleting a customer account in WooCommerce does not delete the person in Tranthor. Delete them in Tranthor, from the customer’s profile.
- WooCommerce’s coupons are not synced.

