juspay/hyperswitch · error

Failed to create event handler

Error message

Failed to create event handler

What it means

Error "Failed to create event handler" thrown in juspay/hyperswitch.

Source

Thrown at crates/router/src/configs/settings.rs:541

pub struct TenantConfig(pub HashMap<id_type::TenantId, Tenant>);

impl TenantConfig {
    /// # Panics
    ///
    /// Panics if Failed to create event handler
    pub async fn get_store_interface_maps(
        &self,
        storage_impl: &app::StorageImpl,
        conf: &configs::Settings,
        cache_store: Arc<storage_impl::redis::RedisStore>,
        testable: bool,
    ) -> (StorageInterfaceMap, AccountsStorageInterfaceMap) {
        #[allow(clippy::expect_used)]
        let event_handler = conf
            .events
            .get_event_handler()
            .await
            .expect("Failed to create event handler");
        let tenant_stores =
            futures::future::join_all(self.0.iter().map(|(tenant_name, tenant)| async {
                let store = Box::pin(AppState::get_store_interface(
                    storage_impl,
                    &event_handler,
                    conf,
                    tenant,
                    conf.master_database.clone().into_inner(),
                    conf.accounts_database_config(),
                    cache_store.clone(),
                    testable,
                ))
                .await;
                (tenant_name.clone(), store)
            }))
            .await;

        let stores = tenant_stores

View on GitHub (pinned to 3093f22cc4)

Solutions

1. Check the events/kafka configuration and that the event backend is reachable

When it happens

Trigger: Thrown at crates/router/src/configs/settings.rs:548 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of juspay/hyperswitch@3093f22cc4 (2026-08-19). Data as JSON: /api/errors/ee66ef08de8dc779. Report an issue: GitHub.