Stripe Connect Troubleshooting Guide
This comprehensive guide helps you resolve common issues with Stripe Connect integration. Find solutions for verification delays, account restrictions, connection errors, and payout problems.
Common Connection Issues
Setup Process Fails or Times Out
Symptoms:- Browser redirects fail
- Setup dialog doesn't load
- "Connection timeout" errors
- Blank pages during setup
-
Clear Browser Data
- Clear cache and cookies
- Disable browser extensions
- Try incognito/private browsing mode
-
Check Browser Requirements
- Enable JavaScript
- Use a supported browser (Chrome, Firefox, Safari, Edge)
- Update to latest browser version
- Disable ad blockers temporarily
-
Network Issues
- Check internet connection stability
- Try a different network/WiFi
- Disable VPN temporarily
- Check firewall settings
-
Alternative Setup Method
- Try from a different device
- Use mobile browser if desktop fails
- Contact support for manual setup assistance
"Invalid Response Format" Errors
Symptoms:- Error messages about API response format
- Setup process stops unexpectedly
- Connection appears successful but fails
-
Wait and Retry
- Server issues may be temporary
- Wait 5-10 minutes and try again
- Check MentorSimply status page
-
Contact Support
- Include error message details
- Provide timestamp of error
- Include browser and device information
Account Verification Issues
Verification Takes Too Long
Expected Timeline:- Express Accounts: 1-24 hours typically
- Standard Accounts: 2-7 business days
- Complex Cases: Up to 14 business days
- Express account: > 48 hours
- Standard account: > 10 business days
- No communication from Stripe: > 72 hours
-
Check Your Email
- Look for requests for additional documents
- Check spam/junk folders
- Respond promptly to Stripe communications
-
Document Quality Issues
- Ensure documents are clear and readable
- Upload in acceptable formats (JPG, PNG, PDF)
- Make sure all document edges are visible
- Avoid glare or shadows in photos
-
Contact Stripe Support
- Access through your Stripe dashboard
- Provide account ID and timeline
- Ask for specific verification status
Documents Keep Getting Rejected
Common Rejection Reasons: Identity Documents:- Expired or invalid ID
- Poor image quality
- Name mismatch with account
- Unsupported document type
- Outdated business registration
- Incomplete documentation
- Name mismatch with business account
- Invalid EIN format
-
Document Requirements Checklist
- ✅ Document is current (not expired)
- ✅ Name matches account exactly
- ✅ Image is clear and readable
- ✅ All corners/edges are visible
- ✅ Document is in accepted format
-
Common Fixes
- Re-photograph in good lighting
- Ensure flat surface (no curves or folds)
- Use scanner if available
- Verify exact name spelling matches
-
Alternative Documents
- Try different ID types if available
- Use certified copies for business documents
- Contact issuing authority for replacement documents
EIN Verification Problems
Common EIN Issues:- Format errors (should be XX-XXXXXXX)
- Newly issued EIN not yet in IRS system
- Mismatch between business name and EIN
- Invalid or fake EIN
-
Verify EIN Format
- Must be 9 digits in XX-XXXXXXX format
- No letters or special characters except hyphen
- Leading zeros are important
-
New EIN Issues
- Wait 24-48 hours after IRS issuance
- Use EIN confirmation letter from IRS
- Contact IRS to verify EIN status: (800) 829-4933
-
Name Mismatch
- Business name in Stripe must match EIN exactly
- Include "LLC", "Inc.", etc. if part of legal name
- Contact IRS if business name changed
Account Status Issues
Account Restricted or Suspended
Possible Reasons:- Incomplete verification
- Suspicious activity detected
- Compliance requirements not met
- Outstanding information requests
-
Check Stripe Dashboard
- Review account status details
- Look for specific restriction reasons
- Check for pending requirements
-
Review Email Communications
- Look for explanation emails from Stripe
- Check for requests for additional information
- Respond to any outstanding requests
-
Contact Stripe Support
- Explain your business model clearly
- Provide any requested documentation
- Ask for specific steps to resolve restriction
"Account Under Review" Status
What This Means:- Stripe is manually reviewing your account
- Common for certain business types or locations
- May require additional documentation
- Account functionality may be limited
- New features may be disabled
- Payouts may be delayed
- Respond Quickly to any information requests
- Provide Complete Information the first time
- Be Patient - complex reviews take time
- Maintain Communication with Stripe support
Payout and Banking Issues
Payouts Not Working
Common Causes:- Bank account verification incomplete
- Account not fully activated
- Payout schedule not configured
- Insufficient balance for payout
-
Verify Bank Account
- Check that bank account is verified in Stripe
- Ensure account details are correct
- Confirm account is active and in good standing
-
Check Payout Settings
- Review payout schedule in Stripe dashboard
- Verify minimum payout amounts
- Check if manual payouts are required
-
Account Status
- Ensure Stripe account is fully activated
- Complete any pending verification steps
- Check for account restrictions
Bank Account Verification Fails
Common Issues:- Incorrect account or routing numbers
- Account name mismatch
- Business account required but personal provided
- Bank doesn't support instant verification
-
Verify Account Details
- Double-check account and routing numbers
- Ensure account holder name matches exactly
- Use business account for business entities
-
Alternative Verification
- Use micro-deposit verification if available
- Provide bank statement for manual verification
- Contact bank to confirm account status
-
Account Type Issues
- Use checking account (not savings)
- Ensure account supports ACH transfers
- Consider switching banks if compatibility issues persist
Integration-Specific Issues
Zero Commission Not Available
Requirements for Zero Commission:- Stripe Connect account must be fully connected
- Account must be verified and active
- Feature must be enabled in organization settings
-
Check Connection Status
- Verify Stripe account shows "Connected" status
- Ensure account type badge displays correctly
- Test connection with "Refresh Status" button
-
Account Requirements
- Complete all verification steps
- Resolve any account restrictions
- Ensure payouts are working
-
Settings Configuration
- Navigate to Organization Settings > Billing
- Look for "Commission Settings" section
- Enable "Zero Commission" checkbox
Commission Settings Not Saving
Possible Causes:- Browser session expired
- Network connectivity issues
- Server-side validation errors
- Insufficient permissions
-
Basic Troubleshooting
- Refresh the page and try again
- Check internet connection
- Try from different browser/device
-
Permission Issues
- Ensure you have organization owner/admin access
- Log out and log back in
- Contact organization owner to verify permissions
-
Validation Errors
- Check for error messages on form
- Ensure commission rate is between 0-100%
- Verify all required fields are completed
Browser and Technical Issues
JavaScript Errors
Common Symptoms:- Setup dialog doesn't open
- Buttons don't respond
- Forms don't submit
- Blank or broken pages
-
Browser Requirements
- Enable JavaScript
- Update browser to latest version
- Clear cache and cookies
- Disable conflicting extensions
-
Console Debugging
- Open browser developer tools (F12)
- Check for JavaScript errors in console
- Include error details when contacting support
Mobile Device Issues
Common Problems:- Setup dialog doesn't display properly
- Touch events don't work
- Forms are difficult to use
- Redirects fail on mobile
-
Mobile Browser Tips
- Use desktop browser when possible
- Try different mobile browsers
- Enable desktop mode in browser
- Use mobile device's built-in browser
-
Alternative Methods
- Complete setup on desktop
- Use mobile hotspot for desktop device
- Contact support for assistance
Getting Additional Help
Before Contacting Support
Gather This Information:- Organization name and ID
- Stripe account ID (if available)
- Error messages (exact text)
- Browser and device information
- Timeline of issues
- Screenshots of problems
MentorSimply Support
Email: support@mentorsimply.com Include in Your Message:- Clear description of the issue
- Steps you've already tried
- Any error messages
- Urgency level and business impact
Stripe Support
Access Through:- Your Stripe dashboard
- Chat support (when available)
- Email support through dashboard
- Account verification issues
- Document rejection problems
- Payout failures
- Account restrictions
Emergency Situations
Immediate Action Required:- Account suspended before important payment
- Critical verification deadline approaching
- Suspected fraudulent activity
- Use live chat if available
- Mark support requests as urgent
- Call Stripe phone support (if available in your region)
- Consider alternative payment processing temporarily
Prevention Tips
Avoiding Common Issues
-
Plan Ahead
- Start setup process early
- Gather all documents before beginning
- Allow extra time for verification
-
Keep Information Updated
- Update business information when changed
- Renew documents before expiration
- Monitor account health regularly
-
Follow Best Practices
- Use business accounts for business purposes
- Maintain separate business and personal finances
- Keep documentation organized and accessible
Regular Maintenance
Monthly Checks:- Review account status in Stripe dashboard
- Verify payout schedules are working
- Check for any new requirements or updates
- Update business information if changed
- Review commission and payout settings
- Ensure compliance with any new requirements