WooCommerce and Aggregate
Last updated
Short answer: Aggregate reads your WooCommerce store's orders and refunds with a read-only key and keeps one sales report per month, so you can ask your AI how the store is doing next to your payments, bank and books. It can't change your store, and it can't move money.
Status: Beta. It's built to WooCommerce's documentation and is still being checked with real stores, so if a number looks off, tell us at support@aggregate.finance.
What it reads
- Order totals: each order's status, currency, date, total, tax and shipping.
- Refund totals: each refund's amount and its tax and shipping parts.
No customer names, emails or addresses, and no product details. Aggregate asks WooCommerce for the total fields only.
What the monthly report is
For each month, Aggregate keeps what the store reports: sales, shipping, sales tax and refunds, in each currency the store sells in. It's a sales report, not booked revenue. The money from those orders arrives through Stripe, PayPal or your bank, which Aggregate already books, so counting the orders as revenue too would count each sale twice.
- Orders that count: completed, processing and refunded. A fully refunded order was still sold, and its refund comes off in the month the refund was made.
- Orders left out: pending, on hold, failed, cancelled and any status a plugin adds. The sync says how many.
- Months are the store's own, by the date each order was placed. The last 6 months are worked out again on every sync, because an order cancelled now changes the month it was placed in. The first sync reads 24 months.
Make a read-only key
- In WordPress, open WooCommerce → Settings → Advanced → REST API.
- Choose Add key, name it "Aggregate", and set Permissions to Read.
- Choose Generate API key, then copy the consumer key (starts
ck_) and the consumer secret (startscs_).
The store needs WooCommerce 9.0 or later, and WordPress permalinks set to anything but Plain.
Connect
- Sign in to Aggregate at app.aggregate.finance.
- Open Workspace → Connections → + Add a connection → WooCommerce (marked Beta).
- Type your store's address (the one customers see, starting
https://) and paste the key and secret. - Aggregate checks the key is Read only before it saves it. A key that can change your store is refused. The key is stored encrypted.
- Connect your AI to Aggregate and ask about your sales.
How we check
On the hosted app, Aggregate sends one empty request to a WooCommerce address that doesn't exist. A Read key is refused with WooCommerce's own "not allowed" answer. A key that can write gets "not found" instead, so Aggregate refuses it. Any other answer is refused too. Nothing in your store changes. The check runs when you connect and again at the start of every sync. A key that can now change the store is disconnected and deleted, and your data stays.
Disconnect and delete
Disconnect WooCommerce in Aggregate at any time, and choose Disconnect and delete its data to delete what it brought in. Then revoke the key in WordPress (WooCommerce → Settings → Advanced → REST API → Revoke), because WooCommerce has no way for an app to end its own key. Backups are kept for 25 days, so deleted data is gone from backups within 30 days.
To delete all your data, delete your workspace. See Privacy.
Questions people ask
Can my AI change my store? No. Aggregate accepts only a Read key, and it only reads.
Why don't my store's sales show as revenue? Because the same money is already booked from Stripe, PayPal or your bank. The monthly report sits beside it, so your AI can compare what the store sold with what arrived.
What does it cost? Aggregate is free while we're in beta. We may introduce paid plans later, and we'll let you know before anything changes.
Who do I contact? support@aggregate.finance.
Related
Last checked 2026-11-13.
© 2026 Aggregate Finance LLC