Skip to content

Email Testing

Test email configuration and delivery.

Email Testing allows you to verify your email provider configuration works correctly before enabling production emails. Send test emails to verify SMTP/Gmail/Office 365 setup.

Navigation: Admin → Tools → Email Testing

Testing Email Configuration

Send Test Email

  1. Go to Admin → Tools → Email Testing
  2. Select Email Provider (if multiple configured)
  3. Enter Recipient Email
  4. Click Send Test Email
  5. Check recipient inbox

Test Email Contents

Test email includes:

  • System name and timestamp
  • Configuration status
  • Provider details
  • Test message
  • Delivery confirmation

Interpreting Results

Success - Email delivered successfully

  • ✅ Provider working
  • ✅ Credentials valid
  • ✅ Network connectivity OK
  • ✅ Ready for production

Failed - Email delivery failed

  • ❌ Check error message for reason
  • ❌ Verify credentials
  • ❌ Test network connectivity
  • ❌ Check provider status

SMTP Testing

Test SMTP Server

  1. Email Provider - Select SMTP
  2. Test Connection - Verify server connection
  3. Send Test Email - Send test via SMTP

SMTP Test Failures

Error Solution
Connection refused Verify server address/port
Authentication failed Check username/password
Timeout Check firewall, network
Encryption error Try different TLS/SSL

Gmail Testing

Test Gmail Configuration

  1. Select Gmail as provider
  2. Verify authorization complete
  3. Click Send Test Email
  4. Verify received

Gmail Test Failures

  • Not Authorized - Reauthorize Gmail account
  • Quota Exceeded - Wait for quota reset (24h)
  • Invalid Scope - Check OAuth permissions
  • Token Expired - Reauthorize

Office 365 Testing

Test Office 365 Configuration

  1. Select Office 365 as provider
  2. Verify tenant/client ID configured
  3. Click Send Test Email
  4. Verify received

Office 365 Test Failures

  • Invalid Tenant - Verify tenant ID
  • Not Authorized - Reauthorize account
  • Mailbox Missing - Verify sender email has mailbox
  • Token Expired - Reauthorize

Testing Workflow

Before Production

  1. Configure Email (Settings → Email)
  2. Test Connection (Email Settings)
  3. Send Test Email (Email Testing)
  4. Verify Receipt (Check inbox)
  5. Enable Production (POS Email Settings)

Troubleshooting Failed Test

  1. Send test email
  2. If fails, note error message
  3. Check relevant provider guide:
  4. SMTP
  5. Gmail
  6. Office 365
  7. Fix configuration
  8. Retry test

Email Testing Best Practices

  • ✅ Test before enabling production
  • ✅ Use your own email for testing
  • ✅ Note test email in email queue
  • ✅ Test from different registers if possible
  • ✅ Verify with multiple recipients
  • ✅ Test at different times
  • ✅ Keep test documentation
POS Emails

Monitor sent emails