Shopify App
Install LostChurn from the Shopify App Store to recover failed subscription payments automatically.
The LostChurn Shopify App embeds directly in your Shopify admin. View recovery stats, manage failed payments, and track recovery campaigns without leaving your store.
What You Get
After installation, the LostChurn app appears in your Shopify admin sidebar with these pages:
- Recovery Dashboard -- At-a-glance stats: revenue recovered, recovery rate, active campaigns, and failed payments in progress.
- Failed Payments -- A list of all subscription billing failures with decline reasons, retry status, and customer details.
- Payment Detail -- Timeline view of each recovery attempt for a specific payment, including retries, emails sent, and customer actions.
- Campaigns -- View and manage active dunning campaigns running against your Shopify subscription failures.
- Customers -- Browse customers with failed payments, see their recovery history and churn risk scores.
- Settings -- Configure recovery preferences, notification settings, and API connections.
Install from the Shopify App Store
- Visit the LostChurn app on the Shopify App Store.
- Click Add app.
- Review the permissions LostChurn requests:
- Orders (Read) -- monitor payment outcomes
- Customers (Read) -- personalize recovery communications
- Billing (Read) -- access subscription billing data
- Webhooks (Read/Write) -- receive real-time payment events
- Click Install app to authorize.
- You are redirected to the LostChurn setup screen inside your Shopify admin.
LostChurn uses Shopify's standard OAuth flow. Your Shopify password is never shared with LostChurn. Tokens are stored securely and managed by Shopify.
Initial Setup
After installation:
- Connect your LostChurn account -- Sign in to your existing LostChurn account or create one. The app links your Shopify store to your LostChurn workspace automatically.
- Webhooks register automatically -- LostChurn creates the required webhook subscriptions in your store. No manual webhook configuration is needed.
- Choose your recovery strategy -- Select a default recovery campaign or create a custom one from the Settings page.
GDPR Compliance
The LostChurn Shopify App implements all three mandatory GDPR webhooks required by Shopify:
| Webhook | Purpose |
|---|---|
customers/data_request | Returns all data LostChurn holds for a specific customer |
customers/redact | Deletes all customer data from LostChurn systems |
shop/redact | Deletes all store data when the app is uninstalled |
These webhooks are registered automatically during installation. When Shopify sends a GDPR request, LostChurn processes it within 48 hours and confirms completion.
What Payment Events Are Tracked
LostChurn receives and processes these Shopify webhook events:
| Event | What Happens |
|---|---|
subscription_billing_attempts/failure | Creates a failed payment record, triggers retry evaluation |
subscription_billing_attempts/success | Marks recovery as successful, stops active dunning |
subscription_billing_attempts/challenged | Sends authentication request email to customer |
subscription_contracts/create | Registers new subscription for monitoring |
subscription_contracts/update | Updates subscription status and plan details |
orders/cancelled | Records cancellation event |
orders/paid | Confirms order payment for correlation tracking |
customers/update | Updates customer metadata for dunning personalization |
All webhook payloads are verified using HMAC-SHA256 signatures via the X-Shopify-Hmac-Sha256 header. Requests with invalid signatures are rejected.
Subscription App Compatibility
Shopify's subscription functionality comes from apps rather than Shopify itself. LostChurn works with all major subscription apps:
- Shopify Subscriptions (native) -- full support via Shopify's Subscription APIs
- ReCharge (v2024-01+) -- supported via unified subscription webhooks
- Bold Subscriptions -- supported via unified subscription webhooks
- Loop Subscriptions -- supported via unified subscription webhooks
If you use a subscription app not listed here, contact support to check compatibility.
Shopify Payments vs. Third-Party Gateways
LostChurn receives billing failure events regardless of which payment gateway processed the charge, because events come from Shopify's subscription billing system.
Retry capabilities vary by gateway:
- Shopify Payments (Stripe-powered) -- full retry support
- Third-party gateways -- retry support depends on the gateway's API. LostChurn attempts retries where the gateway supports programmatic charges.
Multi-Store Support
If you operate multiple Shopify stores, install the LostChurn app on each store separately. Each store connects to its own LostChurn workspace with independent events, campaigns, and analytics. Cross-store reporting is available in the LostChurn analytics dashboard.
Troubleshooting
App shows "Connect your account"
Complete the initial setup by signing in to your LostChurn account from within the app.
No events appearing
- Go to your Shopify admin at Settings > Notifications > Webhooks and verify the LostChurn webhooks are listed.
- If webhooks are missing, uninstall and reinstall the app. Webhooks are re-registered during installation.
- Confirm your store has an active subscription app with at least one subscription.
Recovery not triggering
- LostChurn only triggers recovery for
subscription_billing_attempts/failureevents. One-time order payment failures are tracked but do not start recovery campaigns by default. - Check that your recovery campaign is enabled in the app's Settings page.
Development stores
Shopify development stores are fully supported for testing. Events from development stores are labeled with a development badge in the LostChurn Events feed.
Next Steps
- Recovery campaigns -- configure retry timing and dunning sequences
- Analytics dashboard -- track recovery performance across stores
- WooCommerce integration -- if you also sell on WooCommerce