Here are solutions to the most common issues users encounter when setting up and running migrations.

Account Connection Issues

Invalid API Key Error

Verify the key starts with 'sk' or 'rk'
Check if you're using the correct mode (live vs test)
Ensure the key hasn't been deleted from Stripe
Try creating a new key

Insufficient Permissions Error

For restricted keys, verify all required permissions are granted
Consider using a standard secret key temporarily
Check if your Stripe account has the necessary access level

Migration Errors

Customer Not Found Error

This means customer migration hasn't been completed
Use Stripe's customer migration tool first
Wait for the customer migration to finish (up to 72 hours)
Verify customers exist in the destination account

Product Creation Failed Error

Check if products with the same name already exist
Verify your destination account has sufficient permissions
Ensure tax codes are valid in the destination account

Subscription Creation Failed Error

Confirm the customer exists in the destination account
Verify all referenced products and prices exist
Check if payment methods are properly set up

Performance Issues

Migration Taking Too Long

Large datasets may take several hours
Check the migration logs for progress updates
Contact support if it's been more than 24 hours

Rate Limiting

Stripe imposes API rate limits
Our system automatically handles retries
This may slow down large migrations

Data Validation Issues

Missing Objects After Migration

Check the migration logs for any errors
Verify all prerequisites were met
Some objects may have been skipped due to dependencies

Billing Dates Don't Match

This is normal - new subscriptions start fresh billing cycles
You can manually adjust billing dates if needed
Consider prorating charges for partial periods

Getting Additional Help

If you're still experiencing issues:
1. Check the migration logs for detailed error messages
2. Search our help center for specific error codes
3. Contact support with your migration ID and error details
4. Include screenshots of any error messages

Our support team typically responds within 24 hours.