Troubleshooting Guide - Common Issues & Solutions

!Troubleshooting Support

Encountering issues with your doin9 store? This comprehensive troubleshooting guide covers the most common problems and their solutions. From technical glitches to operational challenges, find quick fixes and detailed solutions to keep your store running smoothly.

Table of Contents

1. Platform & Technical Issues

2. Payment & Checkout Problems

3. Shipping & Fulfillment Issues

4. Product & Inventory Problems

5. Customer Account Issues

6. Performance & Speed Problems

7. Design & Display Issues

8. Getting Additional Help

Platform & Technical Issues

Login & Access Problems

#### Cannot Access Admin Dashboard

```

Problem: Unable to log into DoingHub admin panel

Symptoms: Login page not loading, incorrect credentials error, infinite loading

Solutions:

├── Check Credentials

│ ├── Verify username/email is correct

│ ├── Ensure password is typed correctly

│ ├── Check for caps lock or special characters

│ └── Try password reset if unsure

├── Browser Issues

│ ├── Clear browser cache and cookies

│ ├── Try incognito/private browsing mode

│ ├── Disable browser extensions temporarily

│ └── Try a different browser

├── Network Issues

│ ├── Check internet connection stability

│ ├── Try different network (mobile hotspot)

│ ├── Disable VPN if using one

│ └── Check firewall settings

└── Account Issues

├── Verify account is active

├── Check for suspended account notifications

├── Confirm you're using correct login URL

└── Contact support if account locked

```

#### Website Not Loading

```javascript

const websiteIssues = {

// DNS problems

dnsIssues: {

symptoms: ["Domain not found", "Server not found", "DNS error"],

solutions: [

"Check domain registration status",

"Verify DNS settings with registrar",

"Wait for DNS propagation (24-48 hours)",

"Try accessing via IP address"

]

},

// Server problems

serverIssues: {

symptoms: ["500 error", "503 error", "Server timeout"],

solutions: [

"Check server status page",

"Wait for automatic recovery",

"Contact hosting provider",

"Check for maintenance notifications"

]

},

// SSL certificate issues

sslIssues: {

symptoms: ["SSL certificate error", "Not secure warning"],

solutions: [

"Renew SSL certificate",

"Check certificate installation",

"Verify domain matches certificate",

"Contact support for SSL issues"

]

}

};

```

Database & Data Issues

#### Data Not Syncing

```

Problem: Changes not appearing or data inconsistencies

Symptoms: Orders not updating, inventory not reflecting changes, customer data missing

Troubleshooting Steps:

├── Check System Status

│ ├── Visit status.doin9.com for service status

│ ├── Check for maintenance notifications

│ ├── Verify no ongoing outages

│ └── Look for performance degradation alerts

├── Clear Cache

│ ├── Clear browser cache completely

│ ├── Clear application cache in admin

│ ├── Force refresh pages (Ctrl+F5)

│ └── Log out and log back in

├── Verify Permissions

│ ├── Check user role permissions

│ ├── Verify API access if using integrations

│ ├── Confirm account has necessary privileges

│ └── Test with admin account if available

└── Data Validation

├── Check data format requirements

├── Verify required fields are completed

├── Look for validation error messages

└── Test with minimal data set

```

Payment & Checkout Problems

Payment Processing Issues

#### Payment Failures

```javascript

const paymentTroubleshooting = {

// Card declined issues

cardDeclined: {

commonCauses: [

"Insufficient funds",

"Expired card",

"Incorrect card details",

"Bank fraud protection",

"International transaction blocked"

],

customerSolutions: [

"Verify card details are correct",

"Check with bank for transaction blocks",

"Try different payment method",

"Use different card",

"Contact card issuer"

],

merchantActions: [

"Check payment gateway settings",

"Verify merchant account status",

"Review fraud detection rules",

"Test with different test cards",

"Contact payment processor"

]

},

// Gateway errors

gatewayErrors: {

error_codes: {

"timeout": "Payment gateway timeout - retry transaction",

"invalid_merchant": "Merchant account configuration issue",

"duplicate_transaction": "Duplicate transaction detected",

"invalid_amount": "Transaction amount format error"

},

solutions: {

"timeout": "Retry payment, check gateway status",

"invalid_merchant": "Verify merchant account settings",

"duplicate_transaction": "Wait before retrying, check order status",

"invalid_amount": "Check currency and amount formatting"

}

}

};

```

#### Checkout Process Problems

```

Problem: Customers unable to complete checkout

Symptoms: Checkout page not loading, payment form errors, order not processing

Solutions:

├── Form Validation Issues

│ ├── Check required field validation

│ ├── Verify address format requirements

│ ├── Test with different browsers

│ └── Ensure JavaScript is enabled

├── Payment Method Problems

│ ├── Verify payment methods are active

│ ├── Check payment gateway configuration

│ ├── Test payment processing manually

│ └── Review payment method restrictions

├── Shipping Calculation Errors

│ ├── Verify shipping zones are configured

│ ├── Check shipping rate calculations

│ ├── Test with different addresses

│ └── Review shipping method availability

└── Tax Calculation Issues

├── Verify tax settings configuration

├── Check tax service integration

├── Test with different locations

└── Review tax exemption rules

```

Refund & Return Issues

#### Refund Processing Problems

```javascript

const refundTroubleshooting = {

// Refund delays

refundDelays: {

causes: [

"Payment processor delays (3-5 business days)",

"Bank processing time (5-10 business days)",

"Weekend/holiday delays",

"International transaction delays"

],

actions: [

"Provide refund reference number",

"Explain typical processing times",

"Offer to check refund status",

"Escalate if beyond normal timeframe"

]

},

// Partial refund issues

partialRefunds: {

scenarios: [

"Return shipping costs deducted",

"Restocking fees applied",

"Damaged item partial refund",

"Used item depreciation"

],

communication: [

"Clearly explain refund calculation",

"Provide itemized refund breakdown",

"Reference return policy terms",

"Offer alternative solutions if applicable"

]

}

};

```

Shipping & Fulfillment Issues

Shipping Problems

#### Shipping Rates Not Calculating

```

Problem: Shipping costs not displaying or calculating incorrectly

Symptoms: No shipping options, wrong rates, shipping errors at checkout

Troubleshooting:

├── Shipping Zone Configuration

│ ├── Verify shipping zones are set up correctly

│ ├── Check zone coverage includes customer location

│ ├── Ensure shipping methods are active

│ └── Test with known working addresses

├── Rate Calculation Issues

│ ├── Check product weight and dimensions

│ ├── Verify shipping class assignments

│ ├── Test rate calculation manually

│ └── Review carrier API integration

├── Address Validation

│ ├── Verify address format requirements

│ ├── Check for special characters in address

│ ├── Test with simplified address format

│ └── Validate postal/ZIP code format

└── Carrier Integration

├── Check API credentials are valid

├── Verify carrier service availability

├── Test carrier API connection

└── Review carrier account status

```

#### Tracking Information Issues

```javascript

const trackingIssues = {

// Missing tracking numbers

missingTracking: {

causes: [

"Order not yet shipped",

"Tracking number not generated",

"Manual shipping without tracking",

"Carrier system delays"

],

solutions: [

"Check order fulfillment status",

"Generate tracking number manually",

"Contact shipping carrier",

"Update customer with status"

]

},

// Incorrect tracking information

incorrectTracking: {

causes: [

"Wrong tracking number entered",

"Tracking number format error",

"Carrier system error",

"Package not yet in carrier system"

],

solutions: [

"Verify tracking number accuracy",

"Check with carrier directly",

"Provide corrected tracking info",

"Investigate with fulfillment team"

]

}

};

```

Delivery Problems

#### Package Delivery Issues

```

Problem: Packages not delivered or delivery problems

Symptoms: Package marked delivered but not received, damaged packages, wrong address delivery

Resolution Process:

├── Delivery Confirmation Issues

│ ├── Check delivery confirmation details

│ ├── Verify delivery address accuracy

│ ├── Contact carrier for delivery proof

│ └── Check with neighbors or building management

├── Damaged Package Claims

│ ├── Document damage with photos

│ ├── File claim with shipping carrier

│ ├── Offer immediate replacement

│ └── Review packaging procedures

├── Lost Package Investigation

│ ├── File lost package claim with carrier

│ ├── Provide insurance claim documentation

│ ├── Offer replacement or refund

│ └── Follow up on carrier investigation

└── Wrong Address Delivery

├── Verify original shipping address

├── Contact carrier for package retrieval

├── Arrange redelivery to correct address

└── Update address validation procedures

```

Product & Inventory Problems

Inventory Management Issues

#### Stock Level Discrepancies

```javascript

const inventoryIssues = {

// Overselling problems

overselling: {

causes: [

"Inventory not updated in real-time",

"Multiple sales channels not synced",

"Manual inventory adjustments missed",

"System lag during high traffic"

],

prevention: [

"Enable real-time inventory tracking",

"Set up low stock alerts",

"Regular inventory audits",

"Implement safety stock levels"

],

resolution: [

"Contact affected customers immediately",

"Offer alternatives or backorder",

"Provide estimated restock date",

"Consider expedited shipping for replacement"

]

},

// Inventory sync issues

syncIssues: {

symptoms: [

"Different stock levels across channels",

"Inventory not updating after sales",

"Manual adjustments not reflecting",

"Import/export data mismatches"

],

solutions: [

"Force inventory sync",

"Check integration settings",

"Verify API connections",

"Perform manual inventory count"

]

}

};

```

#### Product Display Problems

```

Problem: Products not displaying correctly or missing information

Symptoms: Images not loading, descriptions missing, prices incorrect, variants not showing

Solutions:

├── Image Display Issues

│ ├── Check image file formats (JPG, PNG, WebP)

│ ├── Verify image file sizes (< 2MB recommended)

│ ├── Test image URLs directly

│ └── Clear CDN cache if using one

├── Product Information Missing

│ ├── Verify all required fields are completed

│ ├── Check for special characters in descriptions

│ ├── Ensure proper formatting in rich text

│ └── Test product save and publish process

├── Pricing Display Problems

│ ├── Check currency settings

│ ├── Verify price format configuration

│ ├── Test with different customer groups

│ └── Review tax-inclusive pricing settings

└── Variant Configuration Issues

├── Verify variant options are set up correctly

├── Check variant pricing and inventory

├── Test variant selection functionality

└── Ensure variant images are assigned

```

Customer Account Issues

Account Access Problems

#### Customer Login Issues

```

Problem: Customers unable to access their accounts

Symptoms: Login failures, password reset not working, account locked

Customer Support Script:

├── Verify Account Details

│ ├── "Can you confirm the email address you used to register?"

│ ├── "Have you tried both your email and username to log in?"

│ ├── "Are you sure about the spelling of your email address?"

│ └── "Have you recently changed your email address?"

├── Password Reset Process

│ ├── "Let me send you a password reset link"

│ ├── "Please check your spam/junk folder"

│ ├── "The reset link expires in 24 hours"

│ └── "Try the reset process from a different device"

├── Account Status Check

│ ├── Check if account is active

│ ├── Verify account hasn't been suspended

│ ├── Look for any security flags

│ └── Check for duplicate accounts

└── Technical Troubleshooting

├── "Please try clearing your browser cache"

├── "Try logging in from an incognito window"

├── "Can you try from a different browser?"

└── "Are you using any browser extensions that might interfere?"

```

Order History & Tracking

#### Order Information Problems

```javascript

const orderIssues = {

// Missing orders in account

missingOrders: {

causes: [

"Guest checkout used instead of account",

"Different email address used",

"Order placed before account creation",

"Account sync issues"

],

solutions: [

"Search by order number or email",

"Link guest orders to account",

"Verify email address used for order",

"Manual order association if needed"

]

},

// Incorrect order status

incorrectStatus: {

causes: [

"Status update delays",

"Manual status not updated",

"Integration sync issues",

"Fulfillment system errors"

],

solutions: [

"Check actual fulfillment status",

"Update status manually if needed",

"Sync with fulfillment system",

"Provide accurate status to customer"

]

}

};

```

Performance & Speed Problems

Site Speed Issues

#### Slow Loading Pages

```

Problem: Website loading slowly or timing out

Symptoms: Long page load times, images loading slowly, checkout process slow

Performance Optimization:

├── Image Optimization

│ ├── Compress large images (use WebP format)

│ ├── Implement lazy loading for images

│ ├── Use appropriate image sizes

│ └── Enable image CDN if available

├── Code Optimization

│ ├── Minify CSS and JavaScript files

│ ├── Remove unused plugins/extensions

│ ├── Enable browser caching

│ └── Optimize database queries

├── Server Performance

│ ├── Check server resource usage

│ ├── Upgrade hosting plan if needed

│ ├── Enable server-side caching

│ └── Use Content Delivery Network (CDN)

└── Third-party Services

├── Review third-party script loading

├── Optimize analytics and tracking codes

├── Minimize external API calls

└── Use asynchronous loading where possible

```

#### Mobile Performance Issues

```javascript

const mobilePerformance = {

// Common mobile issues

issues: {

slowLoading: "Mobile pages loading slower than desktop",

touchProblems: "Touch interactions not working properly",

displayIssues: "Layout problems on mobile devices",

keyboardIssues: "Virtual keyboard causing layout shifts"

},

// Mobile optimization

optimization: {

responsive: "Ensure responsive design implementation",

touchTargets: "Make touch targets at least 44px",

viewport: "Set proper viewport meta tag",

fonts: "Use system fonts for faster loading"

},

// Testing tools

testing: [

"Google PageSpeed Insights",

"GTmetrix mobile testing",

"Real device testing",

"Chrome DevTools mobile simulation"

]

};

```

Design & Display Issues

Theme & Layout Problems

#### Design Not Displaying Correctly

```

Problem: Theme elements not showing properly or layout broken

Symptoms: Misaligned elements, missing styles, broken responsive design

Troubleshooting:

├── Browser Compatibility

│ ├── Test in multiple browsers (Chrome, Firefox, Safari, Edge)

│ ├── Check for browser-specific CSS issues

│ ├── Verify JavaScript compatibility

│ └── Test on different operating systems

├── CSS Issues

│ ├── Check for CSS syntax errors

│ ├── Verify CSS file loading properly

│ ├── Look for conflicting styles

│ └── Test with browser developer tools

├── Responsive Design Problems

│ ├── Test on various screen sizes

│ ├── Check media query breakpoints

│ ├── Verify mobile-first approach

│ └── Test touch interactions on mobile

└── Custom Code Issues

├── Review recent custom code changes

├── Check for JavaScript errors in console

├── Verify third-party integrations

└── Test with default theme temporarily

```

Content Display Issues

#### Text & Media Problems

```javascript

const contentIssues = {

// Text display problems

textIssues: {

encoding: "Special characters not displaying correctly",

fonts: "Custom fonts not loading",

formatting: "Rich text formatting lost",

translation: "Multi-language content issues"

},

// Media display problems

mediaIssues: {

images: "Images not loading or displaying incorrectly",

videos: "Video playback issues",

icons: "Icon fonts or SVGs not showing",

galleries: "Product image galleries not working"

},

// Solutions

solutions: {

encoding: "Check UTF-8 encoding settings",

fonts: "Verify font file paths and formats",

formatting: "Check HTML/markdown syntax",

images: "Verify image URLs and file permissions",

videos: "Check video format compatibility",

icons: "Ensure icon font files are loaded"

}

};

```

Getting Additional Help

Support Resources

#### Self-Service Options

```

Available Resources:

├── Documentation

│ ├── Complete user guides and tutorials

│ ├── API documentation for developers

│ ├── Video tutorials and walkthroughs

│ └── Best practices and optimization guides

├── Community Support

│ ├── Community forum discussions

│ ├── User-generated solutions and tips

│ ├── Feature requests and feedback

│ └── Peer-to-peer assistance

├── Knowledge Base

│ ├── Frequently asked questions (FAQ)

│ ├── Common issue solutions

│ ├── Step-by-step troubleshooting guides

│ └── Platform updates and announcements

└── Status & Updates

├── System status page (status.doin9.com)

├── Maintenance notifications

├── Service disruption alerts

└── Performance monitoring

```

#### Direct Support Channels

```javascript

const supportChannels = {

// Live chat support

liveChat: {

availability: "24/7 for urgent issues",

responseTime: "< 2 minutes average",

bestFor: "Quick questions and immediate assistance",

access: "Available in admin dashboard"

},

// Email support

emailSupport: {

address: "support@doin9.com",

responseTime: "< 4 hours during business hours",

bestFor: "Detailed issues requiring investigation",

include: "Screenshots, error messages, steps to reproduce"

},

// Phone support

phoneSupport: {

availability: "Business hours for premium plans",

number: "1-800-doin9-HELP",

bestFor: "Complex issues requiring screen sharing",

preparation: "Have account details and issue description ready"

},

// Priority support

prioritySupport: {

availability: "24/7 for enterprise customers",

responseTime: "< 30 minutes",

features: "Dedicated account manager, direct escalation",

access: "Available for enterprise and premium plans"

}

};

```

Escalation Process

#### When to Escalate Issues

```

Escalation Criteria:

├── Technical Issues

│ ├── System-wide outages or performance issues

│ ├── Data loss or corruption problems

│ ├── Security vulnerabilities or breaches

│ └── Critical functionality not working

├── Business Impact

│ ├── Issues preventing sales or order processing

│ ├── Payment processing failures

│ ├── Customer-facing problems affecting reputation

│ └── Compliance or legal concerns

├── Resolution Timeline

│ ├── Issues not resolved within SLA timeframes

│ ├── Repeated occurrences of same problem

│ ├── Workarounds not sufficient for business needs

│ └── Customer satisfaction at risk

└── Communication Needs

├── Need for executive-level communication

├── Media or public relations concerns

├── Regulatory reporting requirements

└── Legal or compliance notifications needed

```

Preparing for Support Contact

#### Information to Gather

```

Before Contacting Support:

├── Account Information

│ ├── Account email address

│ ├── Store URL or domain

│ ├── Plan type and billing information

│ └── User role and permissions

├── Issue Details

│ ├── Detailed description of the problem

│ ├── When the issue first occurred

│ ├── Steps taken to reproduce the issue

│ └── Any error messages received

├── Technical Information

│ ├── Browser type and version

│ ├── Operating system

│ ├── Device type (desktop, mobile, tablet)

│ └── Screenshots or screen recordings

├── Business Impact

│ ├── How the issue affects your business

│ ├── Number of customers affected

│ ├── Revenue impact if applicable

│ └── Urgency level and timeline needs

└── Previous Troubleshooting

├── Steps already attempted

├── Temporary workarounds used

├── Previous support ticket numbers

└── Any relevant system changes made recently

```

---

*This troubleshooting guide covers the most common issues you might encounter with your doin9 store. Remember that most problems have simple solutions, and our support team is always ready to help when you need additional assistance.*

Quick Resolution Tips:

1. Start Simple: Try basic solutions like clearing cache or refreshing the page

2. Document Everything: Take screenshots and note error messages

3. Test Systematically: Isolate variables to identify the root cause

4. Check Status: Always check the system status page first

5. Don't Hesitate: Contact support early if issues persist

*Keep this guide bookmarked for quick reference, and remember that every issue is an opportunity to improve your store's reliability and performance!*