Troubleshooting

Common issues and solutions.

License Issues

"Activation Failed! The Integrity Failed..."

Causes:

• Network connectivity issues
• Invalid purchase code format
• License already activated elsewhere
• Test license not configured

Solutions:

Verify purchase code format (36 characters)

Check network connectivity

Deactivate from other domain first

Clear cache: php artisan cache:clear

"License Already Activated"

Solution:

Deactivate from other domain

Or contact support for manual release

API Connection Issues

"Connection Refused" / "Timeout"

Solutions:

Check Sunsky API status

Test: curl -I https://open.sunsky-online.com

Check firewall settings

Increase timeout in settings

"Invalid Signature"

Solutions:

Verify API secret is correct

Check server time is accurate

Re-enter credentials

Import Issues

Products Not Importing

Solutions:

Check subscription limits

Verify API connection

Check queue worker is running

View logs: tail -f storage/logs/sunsky.log

Images Not Downloading

Solutions:

Check storage permissions

Verify storage link: php artisan storage:link

Check disk space

AI Feature Issues

"AI Features Not Available"

Solutions:

Verify Extended License is active

Check package has AI features enabled

Clear cache

"Invalid API Key" (OpenAI)

Solutions:

Verify OpenAI key is correct

Check OpenAI billing is active

Regenerate key if needed

Performance Issues

Slow Page Loading

Solutions:

Enable caching

Optimize database

Use minified assets

Enable lazy loading

High Memory Usage

Solutions:

Reduce batch size

Use queue workers

Optimize images

Getting Help

Before contacting support:

Check this documentation

Review logs

Gather error messages

Note steps to reproduce

Include in support request:

• Plugin version
• PHP/Laravel version
• Error message
• Screenshot