Troubleshooting Stripe Connect

Common Issues and Solutions:

Issue: "Connect Stripe" Button Not Working

- Solution: Check that you're logged in as a Business Owner or Admin - Solution: Try refreshing the page (Cmd+Shift+R / Ctrl+Shift+R) - Solution: Check browser console for error messages - Solution: Ensure JavaScript is enabled in your browser

Issue: Redirected to Stripe But Can't Complete Onboarding

- Solution: Make sure you have all required documents ready - Solution: Check that your email is verified - Solution: Ensure you're using a supported browser (Chrome, Firefox, Safari, Edge) - Solution: Try completing onboarding in an incognito/private window

Issue: "Account Already Exists" Error

- Solution: Your business may already have a connected account - Solution: Check the Membership Plans tab to see if account is already connected - Solution: If account exists but isn't working, contact support

Issue: Onboarding Complete But Dashboard Shows "Not Connected"

- Solution: Refresh the page (hard refresh: Cmd+Shift+R / Ctrl+Shift+R) - Solution: Wait a few minutes for the system to sync (webhooks update status automatically) - Solution: Log out and log back in - Solution: Check that you completed ALL onboarding steps in Stripe - Solution: Check the progress indicator in Membership Plans tab - it shows which steps are complete - Solution: If you see a progress bar, complete any outstanding requirements listed

Issue: "Restricted Payouts" or "Payments Paused"

- Cause: Your Stripe account needs additional verification - Solution: Log into your Stripe Dashboard - Solution: Check for any outstanding requirements - Solution: Complete any missing information - Solution: Upload requested documents - Solution: Wait for Stripe's review (usually 1-3 business days)

Issue: Can't Add Bank Account

- Solution: Ensure bank account details are correct - Solution: Check that account holder name matches your business name - Solution: Verify routing/account numbers are correct - Solution: Try a different bank account if issues persist - Solution: Contact Stripe Support for bank-specific issues

Issue: Verification Taking Too Long

- Normal: Manual reviews can take 1-3 business days - Solution: Check your email for any requests from Stripe - Solution: Log into Stripe Dashboard to check status - Solution: Ensure all documents are clear and legible - Solution: Contact Stripe Support if it's been more than 3 business days

Issue: Success Message Not Showing After Connection

- Solution: Check URL for `connect_success=1` parameter - Solution: Hard refresh the page (Cmd+Shift+R / Ctrl+Shift+R) - Solution: Navigate away and back to Business page - Solution: Check that onboarding was fully completed in Stripe

Issue: Can't Create Services After Connecting

- Solution: Verify connection status in Business → Membership Plans tab - Solution: Ensure Stripe account is fully verified (not restricted) - Solution: Check that you have the correct permissions (Owner/Admin) - Solution: Try logging out and back in

Issue: Payments Not Processing

- Solution: Check Stripe account status (not restricted) - Solution: Verify bank account is added and verified - Solution: Check Stripe Dashboard for any errors - Solution: Ensure all verification requirements are complete

Getting Additional Help:

For BuildStability Issues:

- Check this help section - Contact BuildStability support - Check browser console for errors

For Stripe-Specific Issues:

- Log into your Stripe Dashboard (Standard account with full access) - Check for specific error messages - Contact Stripe Support directly - Stripe handles all account verification and processing

Pro Tip: Most issues are related to incomplete Stripe verification. Always check your Stripe Dashboard first for specific requirements.