juspay/hyperswitch · error · ApiErrorResponse::InternalServerError

Finix requires MultiAuthKey auth type

Error message

Finix requires MultiAuthKey auth type

What it means

Error "Finix requires MultiAuthKey auth type" thrown in juspay/hyperswitch.

Source

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

                    password: api_secret.clone(),
                    client_id: key1.clone(),
                    client_secret: key2.clone(),
                }),
                _ => Err(err("Volt requires MultiAuthKey auth type")),
            },
            Connector::Finix => match auth {
                ConnectorAuthType::MultiAuthKey {
                    api_key,
                    key1,
                    api_secret,
                    key2,
                } => Ok(Self::Finix {
                    finix_user_name: api_key.clone(),
                    finix_password: api_secret.clone(),
                    merchant_identity_id: key2.clone(),
                    merchant_id: key1.clone(),
                }),
                _ => Err(err("Finix requires MultiAuthKey auth type")),
            },
            Connector::Cashtocode => match auth {
                ConnectorAuthType::CurrencyAuthKey { auth_key_map } => Ok(Self::Cashtocode {
                    auth_key_map: auth_key_map.clone(),
                }),
                _ => Err(err("Cashtocode requires CurrencyAuthKey auth type")),
            },
            Connector::Payload => match auth {
                ConnectorAuthType::CurrencyAuthKey { auth_key_map } => Ok(Self::Payload {
                    auth_key_map: auth_key_map.clone(),
                }),
                _ => Err(err("Payload requires CurrencyAuthKey auth type")),
            },
            Connector::Worldpayvantiv => match auth {
                ConnectorAuthType::SignatureKey {
                    api_key,
                    key1,
                    api_secret,

View on GitHub (pinned to 3093f22cc4)

Solutions

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

When it happens

Trigger: Thrown at crates/router/src/core/unified_connector_service/connector_config.rs:1586 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/3d496f7d0e6a5975. Report an issue: GitHub.