juspay/hyperswitch · error · ApiErrorResponse

Calida requires HeaderKey auth type

Error message

Calida requires HeaderKey auth type

What it means

Error "Calida requires HeaderKey auth type" thrown in juspay/hyperswitch.

Source

Thrown at crates/router/src/core/unified_connector_service/connector_config.rs:941

                    terminal_id: key2.clone(),
                }),
                _ => Err(err("Fiservcommercehub requires MultiAuthKey auth type")),
            },
            Connector::Calida => match auth {
                ConnectorAuthType::HeaderKey { api_key } => {
                    let calida_meta = metadata
                        .map(|m| {
                            serde_json::from_value::<CalidaMetadata>(m.clone())
                                .map_err(|_| err("Invalid Calida metadata format"))
                        })
                        .transpose()?;

                    Ok(Self::Calida {
                        api_key: api_key.clone(),
                        shop_name: calida_meta.as_ref().map(|m| m.shop_name.clone()),
                    })
                }
                _ => Err(err("Calida requires HeaderKey auth type")),
            },
            Connector::Celero => match auth {
                ConnectorAuthType::HeaderKey { api_key } => Ok(Self::Celero {
                    api_key: api_key.clone(),
                }),
                _ => Err(err("Celero requires HeaderKey auth type")),
            },
            Connector::Helcim => match auth {
                ConnectorAuthType::HeaderKey { api_key } => Ok(Self::Helcim {
                    api_key: api_key.clone(),
                }),
                _ => Err(err("Helcim requires HeaderKey auth type")),
            },
            Connector::Multisafepay => match auth {
                ConnectorAuthType::HeaderKey { api_key } => Ok(Self::Multisafepay {
                    api_key: api_key.clone(),
                }),
                _ => Err(err("Multisafepay requires HeaderKey auth type")),

View on GitHub (pinned to 3093f22cc4)

Solutions

1. Configure the merchant connector account for Calida with the HeaderKey connector_auth_type
2. Recreate/update the connector account credentials to match the HeaderKey schema

When it happens

Trigger: Thrown at crates/router/src/core/unified_connector_service/connector_config.rs:886 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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