# WooCommerce refund automation > Connect WooCommerce with REST API keys. Lumtry opens a case when a refund is recorded, decides it by policy and pays through Stripe or PayPal. - Canonical URL: https://lumtry.com/connectors/woocommerce - Last updated: 2026-09-24 Connect your WooCommerce store to Lumtry with REST API keys. When a refund is recorded on a store order, Lumtry opens a case, decides it under your versioned policy, asks a person when the policy says so, and pays the refund through your connected Stripe or PayPal account, with every step on an append-only audit record. ## What it does - Opens a refund case when a refund is recorded on a WooCommerce order, and decides it with your published policy. - Looks up WooCommerce orders for the shopper portal, so customers can start a return by order number and email. - Lets you publish a policy version that applies only to WooCommerce cases, next to your default policy. ## Set it up 1. **Create your workspace**: Sign up and create a Lumtry workspace for the store. Nothing reaches WooCommerce until an Owner or Admin connects it. 2. **Create REST API keys**: In WooCommerce, open Settings, then Advanced, then REST API, and create a key with Read/Write permissions. 3. **Connect the store**: Paste the store URL, consumer key and consumer secret in the dashboard. Lumtry checks the keys, then registers its refund notification on your store with a secret only Lumtry holds. 4. **Publish a policy and watch first**: Publish your refund rules, then run cases in shadow mode to see what the policy would decide before you switch it on. ## What Lumtry reads - The refund recorded on the order, with the order number, amount and currency. - Order status and the customer's order count, as signals your policy rules can read. - Order lines, variants and stock levels, for shopper portal lookups and return labels. ## What Lumtry writes - The refund notification Lumtry registers on your store when you connect, removed again when you disconnect. - Nothing else. Lumtry does not change orders, stock or notes in WooCommerce; the refund itself runs through Stripe or PayPal. ## Frequently asked questions ### How does Lumtry know a WooCommerce notification is genuine? Lumtry creates a secret for your store when you connect and checks the signature on every notification before it records anything. WooCommerce's unsigned activation ping is answered without touching any data. ### Can Lumtry offer store credit or an exchange on WooCommerce? Not yet. Lumtry cannot write store credit or exchange orders to WooCommerce today, so a case that needs either waits for a person to resolve it by hand. ### Which WooCommerce stores can I connect? One store per workspace, and a store can belong to only one workspace. After connecting, the dashboard shows the store host, the last four characters of the key and a health badge. ### What happens if I disconnect the store? New notifications from the store are recorded but no longer open cases, and cases already in progress continue. Lumtry also tries to remove its notification from the store. ## Related - [Home](https://lumtry.com/index.md): Decide refunds by a versioned policy, send the exceptions to your team in Slack or the dashboard, and keep every step on the record. Start free. - [Integrations](https://lumtry.com/connectors.md): Connect Lumtry to Shopify, WooCommerce, BigCommerce, Amazon, eBay, Stripe, PayPal, Slack, Gorgias, Zendesk, EasyPost and Shippo. Browse every integration. - [Register a connector](https://lumtry.com/connectors/register.md): Directories and AI assistant vendors register their OAuth client metadata here. The team reviews every registration before a workspace can authorize it. - [Shopify](https://lumtry.com/connectors/shopify.md): Connect Shopify to Lumtry so refund requests and order details reach one versioned policy, with every decision kept in an append-only audit trail. - [BigCommerce](https://lumtry.com/connectors/bigcommerce.md): Connect BigCommerce with an API account or the app. Each refund on an order becomes a case your policy decides, paid through Stripe or PayPal. - [Amazon Returns](https://lumtry.com/connectors/amazon.md): Bring Amazon return and refund notifications into one policy-driven queue. Set up with the Lumtry team; nothing is written back to Amazon. - [eBay](https://lumtry.com/connectors/ebay.md): Bring eBay return and refund notifications into one policy-driven queue. Set up with the Lumtry team; nothing is written back to eBay. - [Stripe](https://lumtry.com/connectors/stripe.md): Connect Stripe through Stripe Connect. Approved refunds are paid from the original charge with an idempotency key, so a retry never pays twice. - [PayPal](https://lumtry.com/connectors/paypal.md): Connect PayPal with your REST app credentials. Approved refunds are paid from the original capture, and every PayPal event is signature-checked. - [Slack](https://lumtry.com/connectors/slack.md): Approve or deny held refunds from a Slack channel. Lumtry checks the signature, a single-use token and the approver before it acts. - [Gorgias](https://lumtry.com/connectors/gorgias.md): Tag a Gorgias ticket and Lumtry opens a refund case for the matching order, then posts each step back as an internal note. - [Zendesk](https://lumtry.com/connectors/zendesk.md): Tag a Zendesk ticket and Lumtry opens a refund case for the matching order, then posts each step back as a private comment. - [Twilio](https://lumtry.com/connectors/twilio.md): PIN-checked phone approvals for held refunds to US numbers, placed through Twilio by Lumtry. A voice approvals add-on on paid plans. - [Telnyx](https://lumtry.com/connectors/telnyx.md): PIN-checked phone approvals for held refunds to Canadian numbers, placed through Telnyx by Lumtry. A voice approvals add-on on paid plans. - [EasyPost](https://lumtry.com/connectors/easypost.md): Buy prepaid return labels on your EasyPost account and release the refund when the carrier shows the return delivered. - [Shippo](https://lumtry.com/connectors/shippo.md): Buy prepaid return labels on your Shippo account and release the refund when the carrier shows the return delivered. - [ShipBob](https://lumtry.com/connectors/shipbob.md): Let ShipBob's return scan release the refund and grade each item. Part of the Warehouse Sync add-on on Starter, Growth and Scale. - [ShipHero](https://lumtry.com/connectors/shiphero.md): Let ShipHero's return updates release the refund and grade each item. Part of the Warehouse Sync add-on on Starter, Growth and Scale. - [Pricing](https://lumtry.com/pricing.md): Lumtry plans by case volume and seats, from Free to Enterprise, with add-ons and capped outcome fees. Start free or hear when billing opens. - [MCP server](https://lumtry.com/developers/mcp.md): Connect an AI assistant or your own agent to your refund workspace through the Model Context Protocol. Read cases and propose actions, never move money. - [Trust](https://lumtry.com/trust.md): How Lumtry secures merchant data, keeps AI inside a deterministic refund policy, lists every sub-processor and explains data flow and retention. Review it. - [llms.txt](https://lumtry.com/llms.txt)