BigCommerce App
Install LostChurn from the BigCommerce App Marketplace for automatic failed payment recovery.
The LostChurn BigCommerce App connects via single-click OAuth to add Smart Retry and dunning capabilities for failed payments on your BigCommerce store.
What You Get
After installation, LostChurn:
- Monitors all payment failure events on your store in real time.
- Analyzes decline codes from your payment gateway to determine the best recovery strategy.
- Schedules AI-optimized retries via the BigCommerce Payments API.
- Sends personalized dunning emails with payment update links.
- Updates order status and writes internal notes after successful recovery.
- Tracks recovery performance in your LostChurn dashboard with BigCommerce-specific analytics.
Install from the BigCommerce App Marketplace
- In your BigCommerce Control Panel, go to Apps > Marketplace.
- Search for LostChurn.
- Click Get This App, then Install.
- BigCommerce redirects you to LostChurn to complete the OAuth flow.
- Review the requested permissions and click Authorize.
- You are redirected back to your LostChurn dashboard with the connection confirmed.
Manual Installation
If you prefer to start from LostChurn:
- In your LostChurn dashboard, go to Settings > Integrations and click Connect BigCommerce.
- Enter your BigCommerce Store Hash (found in your store URL:
store-{hash}.mybigcommerce.com). - Click Authorize and complete the OAuth flow in BigCommerce.
OAuth and Permissions
LostChurn requests these OAuth scopes during installation:
| Scope | Permission | Purpose |
|---|---|---|
| Orders | Read/Write | Monitor payment failures, update order status after recovery |
| Customers | Read | Access customer details for dunning communications |
| Transactions | Read | Read decline codes and payment details |
| Products | Read | Include product context in recovery emails |
| Store Information | Read | Read timezone, currency, and store settings |
OAuth tokens are stored securely and refreshed automatically. LostChurn never stores your BigCommerce password.
Webhook Setup
Webhooks are registered automatically during installation. No manual configuration is needed.
| Webhook | Endpoint |
|---|---|
store/order/paymentStatusChanged | https://webhooks.lostchurn.com/v1/bigcommerce |
store/order/statusUpdated | https://webhooks.lostchurn.com/v1/bigcommerce |
store/order/created | https://webhooks.lostchurn.com/v1/bigcommerce |
store/customer/updated | https://webhooks.lostchurn.com/v1/bigcommerce |
All payloads include the X-BC-Webhook-Signature header. LostChurn verifies HMAC-SHA256 signatures on every request.
What Data Syncs
| Event | LostChurn Action |
|---|---|
| Order payment failed | Creates failed payment record, triggers retry evaluation |
| Order payment captured | Marks recovery as successful, stops dunning |
| Order refunded | Records refund for revenue reporting |
| Order cancelled | Records churn event, triggers reactivation campaign |
| Customer payment method updated | Triggers immediate retry of pending failures |
Payment Retry Flow
- LostChurn receives a payment failure webhook.
- The decline code is extracted from the transaction record via BigCommerce's Transactions API.
- LostChurn determines the optimal retry strategy based on decline code and historical success patterns.
- At the scheduled time, LostChurn calls the BigCommerce Payments API to re-attempt the charge.
- On success, order status updates and dunning stops. On failure, the next retry is scheduled.
Multi-Storefront
BigCommerce supports multiple storefronts under a single store. LostChurn processes events from all storefronts through the unified webhook system. Events are tagged with the originating channel ID for filtering in analytics.
Subscription App Compatibility
If you use a third-party subscription app (such as Recharge or PayWhirl), LostChurn receives payment failure events through BigCommerce's unified order system. For deeper subscription lifecycle tracking, consider also connecting the subscription app directly if supported.
Troubleshooting
App not showing in BigCommerce
- Go to your BigCommerce Control Panel at Apps > My Apps and confirm LostChurn is listed.
- If not listed, reinstall from the App Marketplace.
No events flowing
- Verify webhooks are registered by checking Settings > Integrations > BigCommerce in your LostChurn dashboard. The connection status should show "Connected" with a green badge.
- Create a test order with a payment method that simulates a decline and check the LostChurn Events feed.
OAuth authorization failed
- Ensure you are signed into BigCommerce with a Store Owner or Admin account.
- If your store has IP restrictions, confirm the LostChurn IP addresses are allowlisted.
Sandbox stores
BigCommerce sandbox stores are fully supported. LostChurn detects sandbox connections and labels events accordingly. Test data is kept separate from production analytics.
Next Steps
- Recovery campaigns -- configure retry timing and dunning sequences
- Shopify integration -- if you also sell on Shopify
- WooCommerce integration -- if you also sell on WooCommerce