# BigCommerce refund automation

> 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.

- Canonical URL: https://lumtry.com/connectors/bigcommerce
- Last updated: 2026-09-24

Connect your BigCommerce store to Lumtry with a store-level API account or the app install. When a refund is created on an order, Lumtry opens a case, decides it under your versioned policy, routes exceptions to a person, and pays the refund through Stripe or PayPal, with every step on the audit record.

## What it does

- Opens a refund case when a refund is created on a BigCommerce order, and decides it with your published policy.
- Looks up BigCommerce orders for the shopper portal, so customers can start a return themselves.
- Lets you publish a policy version that applies only to BigCommerce cases, next to your default policy.

## Set it up

1. **Create your workspace**: Sign up and create a Lumtry workspace. Only an Owner or Admin can connect a store.
2. **Choose how to connect**: Create a store-level API account in BigCommerce and paste the store hash and access token, or install the Lumtry app from your control panel and use the one-time link to finish connecting.
3. **Let Lumtry register its notification**: Lumtry registers a refund notification on your store that carries a secret only Lumtry knows, and checks that secret on every delivery before recording anything.
4. **Publish a policy and watch first**: Publish your refund rules, then run cases in shadow mode until the decisions match what you expect.

## What Lumtry reads

- The refund created on the order, read back from BigCommerce for its amount and currency.
- Order status and the customer's order count, as signals your policy rules can read.
- Order products, addresses, 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 BigCommerce; the refund itself runs through Stripe or PayPal.

## Frequently asked questions

### Is there a BigCommerce app, or do I paste keys?

Both paths exist. You can paste a store-level API account's store hash and token, or install the app and claim the store from your Lumtry workspace. The app path appears only where the app is enabled, and the Marketplace listing is still in review.

### How does Lumtry verify BigCommerce notifications?

BigCommerce does not sign its notifications, so Lumtry sets a secret header when it registers one and compares that header on every delivery before it writes anything.

### Can Lumtry offer store credit or an exchange on BigCommerce?

Not yet. Lumtry cannot write store credit or exchange orders to BigCommerce today, so a case that needs either waits for a person to resolve it.

### What happens if I uninstall the app or disconnect?

The workspace is disconnected. New notifications no longer open cases, cases already in progress continue, and Lumtry 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.
- [WooCommerce](https://lumtry.com/connectors/woocommerce.md): 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.
- [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)
