Enum StripeWebhookError 

pub enum StripeWebhookError {
    MissingSecret,
    InvalidSecretFormat(String),
    MissingSignature,
    InvalidSignatureFormat(String),
    SignatureVerificationFailed,
    TimestampTooOld {
        age_seconds: i64,
        max_age_seconds: i64,
    },
    TimestampInFuture {
        drift_seconds: i64,
    },
    InvalidPayload(String),
    UnknownEventType(String),
    MissingField(String),
    AlreadyProcessed {
        event_id: String,
    },
    ProcessingFailed(String),
    DatabaseError(String),
    ExternalServiceError(String),
    InternalError(String),
}

Stripe webhook error types with HTTP status code mapping

Variants

MissingSecret

Missing webhook signing secret

InvalidSecretFormat(String)

Invalid secret format

MissingSignature

Missing stripe-signature header

InvalidSignatureFormat(String)

Invalid signature format

SignatureVerificationFailed

Signature verification failed

TimestampTooOld

Timestamp too old (replay attack protection)

Fields

age_seconds: i64

max_age_seconds: i64

TimestampInFuture

Timestamp in future (clock skew)

Fields

drift_seconds: i64

InvalidPayload(String)

Failed to parse request body

UnknownEventType(String)

Unknown event type

MissingField(String)

Missing required field in event

AlreadyProcessed

Event already processed (idempotent)

Fields

event_id: String

ProcessingFailed(String)

Event processing failed

DatabaseError(String)

Database error during processing

ExternalServiceError(String)

External service error

InternalError(String)

Internal error

Implementations

impl StripeWebhookError

pub fn status_code(&self) -> StatusCode

Get the HTTP status code for this error

pub fn should_retry(&self) -> bool

Check if this error should be retried by Stripe

Stripe will retry webhooks that return 5xx errors. We return false for client errors (4xx) to prevent retries.

pub fn error_code(&self) -> &'static str

Get error code for logging/metrics

Trait Implementations

impl Debug for StripeWebhookError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for StripeWebhookError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for StripeWebhookError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl IntoResponse for StripeWebhookError

fn into_response(self) -> Response

Create a response.