smtp_tls_failed

HTTP status: 502 · Code: smtp_tls_failed

The secure connection to the SMTP server failed: a bad certificate, or STARTTLS is not offered.

Why it happens

The secure connection to the SMTP server failed: its certificate is invalid, or it doesn’t offer STARTTLS when the settings ask for it.

How to fix

Check the security setting matches the port: STARTTLS for 587, TLS for 465. Check the host name matches the server’s certificate.

Catch it in your code

Every SDK throws one error type for a failed call. Match on its code, which is always smtp_tls_failed for this error, never on the message.

JavaScript and Next.js

import { ErrorCode, OrvanoError } from '@orvano/js'

try {
  // your Orvano call
} catch (error) {
  if (error instanceof OrvanoError && error.code === ErrorCode.smtpTlsFailed) {
    // handle smtp_tls_failed
  } else {
    throw error
  }
}

Dart and Flutter

import 'package:orvano_flutter/orvano_flutter.dart'; // or orvano_dart on a server

try {
  // your Orvano call
} on OrvanoException catch (error) {
  if (error.code != ErrorCode.smtpTlsFailed) rethrow;
  // handle smtp_tls_failed
}

.NET

using Orvano;

try
{
    // your Orvano call
}
catch (OrvanoException error) when (error.Code == ErrorCode.SmtpTlsFailed)
{
    // handle smtp_tls_failed
}

The error also carries the HTTP status (502), a message, and a request ID. Quote the request ID when you report a problem: the server logs it with the failure. See Errors for how errors work in every SDK, or every error code.