Struct StripeWebhookConfig 

pub struct StripeWebhookConfig {
    pub max_timestamp_age: Duration,
    pub max_clock_drift: Duration,
    pub idempotency_ttl: Duration,
    pub idempotency_max_entries: usize,
    pub processing_timeout: Duration,
    pub max_retries: u32,
    pub retry_base_delay: Duration,
    pub log_payloads: bool,
    /* private fields */
}

Configuration for Stripe webhook handling

Fields

max_timestamp_age: Duration

Maximum age for webhook timestamps (replay attack protection) Stripe recommends 5 minutes (300 seconds)

max_clock_drift: Duration

Maximum allowed clock drift (future timestamps)

idempotency_ttl: Duration

Idempotency TTL - how long to remember processed events

idempotency_max_entries: usize

Maximum number of events to track for idempotency

processing_timeout: Duration

Async processing timeout

max_retries: u32

Number of retry attempts for failed processing

retry_base_delay: Duration

Base delay for exponential backoff (doubles each retry)

log_payloads: bool

Whether to log event payloads (DISABLE in production for PII)

Implementations

impl StripeWebhookConfig

pub fn from_env() -> StripeWebhookResult<Self>

Create configuration from environment variables

Environment Variables

• STRIPE_WEBHOOK_SECRET (required): Webhook signing secret (whsec_…)
• STRIPE_WEBHOOK_MAX_AGE (optional): Max timestamp age in seconds (default: 300)
• STRIPE_WEBHOOK_IDEMPOTENCY_TTL (optional): Idempotency TTL in seconds (default: 86400)
• STRIPE_WEBHOOK_PROCESSING_TIMEOUT (optional): Processing timeout in seconds (default: 30)
• STRIPE_WEBHOOK_MAX_RETRIES (optional): Max retry attempts (default: 3)
• STRIPE_WEBHOOK_LOG_PAYLOADS (optional): Log payloads - DISABLE IN PROD (default: false)

Errors

Returns StripeWebhookError::MissingSecret if STRIPE_WEBHOOK_SECRET is not set.

pub fn retry_delay(&self, attempt: u32) -> Duration

Calculate retry delay with exponential backoff and jitter

Trait Implementations

impl Clone for StripeWebhookConfig

fn clone(&self) -> StripeWebhookConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StripeWebhookConfig

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

Formats the value using the given formatter.