{
  "version": "2",
  "generatedAt": "2026-11-03T22:49:39.280Z",
  "listing": {
    "slug": "juspay--hyperswitch",
    "name": "Hyperswitch",
    "tagline": "Open-source payments switch that routes across 100+ processors, driven by a REST API and SDKs.",
    "shortTagline": "Open-source payments switch",
    "description": "A Rust payments orchestrator from Juspay. You connect Stripe, Adyen, PayPal and other processors once, then create payments, refunds, payouts and routing rules through one API. The Community Edition is Apache-2.0 and self-hosted with Docker or Helm; reconciliation, revenue recovery and cost observability are paid add-ons.",
    "capabilities": [
      "adaptable",
      "operable"
    ],
    "vertical": "invoicing-finance",
    "alternativeTo": [
      "Spreedly"
    ],
    "shape": "business-app",
    "formFactor": "api",
    "executionModel": "deterministic",
    "provenance": "human-written",
    "codeStack": {
      "languages": [
        "Rust",
        "ReScript",
        "TypeScript"
      ],
      "frameworks": [
        "actix-web"
      ],
      "packageManager": "cargo",
      "database": [
        "PostgreSQL",
        "Redis"
      ],
      "hostingTarget": [
        "Docker",
        "Kubernetes (Helm)",
        "AWS",
        "GCP",
        "Azure"
      ]
    },
    "modelStack": null,
    "repos": [
      {
        "url": "https://github.com/juspay/hyperswitch",
        "owner": "juspay",
        "name": "hyperswitch",
        "license": "Apache-2.0",
        "stars": 43569,
        "lastCommit": "2026-09-03"
      }
    ],
    "interface": {
      "kind": "api",
      "url": "https://api-reference.hyperswitch.io/",
      "official": true,
      "hosted": "both"
    },
    "operability": "official",
    "recommendedWrapper": null,
    "reach": [
      {
        "job": "Create, confirm and capture payments",
        "reachable": true,
        "evidence": "Payments API in api-reference.hyperswitch.io; core of the app server"
      },
      {
        "job": "Refunds and disputes",
        "reachable": true,
        "evidence": "Refunds and Disputes endpoints in API reference"
      },
      {
        "job": "Connect payment processors",
        "reachable": true,
        "evidence": "Merchant Connector Account API; also Control Center UI"
      },
      {
        "job": "Intelligent routing rules",
        "reachable": true,
        "evidence": "Routing API and decision-engine service; listed as included in all plans on hyperswitch.io/pricing"
      },
      {
        "job": "Store cards and payment methods (vault)",
        "reachable": true,
        "evidence": "Customers and Payment Methods API; Vault included in all plans"
      },
      {
        "job": "Payouts",
        "reachable": true,
        "evidence": "Payouts API; 'Payout Orchestration' included in all plans"
      },
      {
        "job": "Webhooks to your systems",
        "reachable": true,
        "evidence": "Webhook configuration in business profile API"
      },
      {
        "job": "Hosted checkout and drop-in widgets",
        "reachable": true,
        "evidence": "Payment Links API; hyperswitch-web SDK for embedding"
      },
      {
        "job": "Reconciliation",
        "reachable": false,
        "evidence": "hyperswitch.io/pricing lists Reconciliation as a paid add-on for Community and Enterprise"
      },
      {
        "job": "Revenue recovery and cost observability",
        "reachable": false,
        "evidence": "hyperswitch.io/pricing lists both as paid add-ons"
      }
    ],
    "editions": [
      {
        "name": "Self-Host Community Edition",
        "price": null,
        "open": true,
        "distributions": [
          {
            "kind": "source",
            "url": "https://github.com/juspay/hyperswitch"
          },
          {
            "kind": "container",
            "url": "https://github.com/juspay/hyperswitch",
            "command": "git clone --depth 1 --branch latest https://github.com/juspay/hyperswitch && cd hyperswitch && scripts/setup.sh"
          }
        ]
      },
      {
        "name": "Self-Host Enterprise Edition",
        "price": null,
        "open": false,
        "distributions": [
          {
            "kind": "hosted",
            "url": "https://hyperswitch.io/pricing"
          }
        ]
      },
      {
        "name": "Hyperswitch Cloud",
        "price": null,
        "open": false,
        "distributions": [
          {
            "kind": "hosted",
            "url": "https://app.hyperswitch.io"
          }
        ]
      }
    ],
    "skills": {
      "kind": "none",
      "paths": [],
      "install": null,
      "note": "No SKILL.md, Claude Code plugin, or skills install target in the repo."
    },
    "customization": {
      "summary": "Run scripts/setup.sh for a Docker profile, then edit the TOML config for server, database, Redis, locker and connector settings; docker-compose exposes DATABASE_URL, REDIS_URL and the API keys the Control Center uses. Processor credentials are added per connector in the Control Center or over the API, not in the repo.",
      "envVars": [
        "DATABASE_URL",
        "REDIS_URL",
        "HYPERSWITCH_SERVER_URL",
        "HYPERSWITCH_CLIENT_URL",
        "HYPERSWITCH_CONTROL_CENTER_URL",
        "HYPERSWITCH_PUBLISHABLE_KEY",
        "HYPERSWITCH_SECRET_KEY",
        "LOG_LEVEL",
        "SCHEDULER_FLOW",
        "SDK_ENV"
      ],
      "configFiles": [
        "config/development.toml",
        "config/docker_compose.toml",
        "config/config.example.toml",
        "config/dashboard.toml",
        "docker-compose.yml"
      ],
      "promptFiles": [],
      "effort": "config-only",
      "editCount": 15
    },
    "useWhen": [
      "I am outgrowing a single Stripe integration and want routing and retries across processors without rewriting checkout",
      "I want my agent to create payment links, refunds and payouts through one API regardless of which processor settles them"
    ],
    "accounts": [
      "At least one payment processor account, such as Stripe, Adyen, or PayPal",
      "Hyperswitch Cloud account (Cloud edition only)"
    ],
    "active": true,
    "lastActivity": "2026-09-03",
    "gotchas": [
      "Infrastructure-grade: Postgres, Redis and several services; heavier than an SMB invoicing tool",
      "Reconciliation, revenue recovery and cost observability are paid add-ons even on self-host",
      "Card data handling still needs your own PCI scope decisions; the vault is a separate service"
    ],
    "fit": {
      "adaptable": 3,
      "operable": 3
    },
    "evidence": {
      "formFactor": "Rust app server exposed as REST API; Control Center is a separate repo (README Ecosystem Mapping)",
      "executionModel": "no model at runtime for payments; 'AI-powered cost observability' is a paid add-on outside the open edition",
      "operability": "api-reference.hyperswitch.io published by Juspay; official web and mobile SDKs listed in README",
      "effort": "config/ directory in repo with development.toml, docker_compose.toml, config.example.toml; docker-compose.yml env keys",
      "editions": "hyperswitch.io/pricing: Community free, Enterprise custom, Cloud custom; add-ons listed",
      "active": "GitHub pushedAt 2026-09-03; 2,141 open issues at triage"
    },
    "confidence": {
      "formFactor": 0.9,
      "executionModel": 0.85,
      "operability": 0.95,
      "effort": 0.8,
      "reach": 0.75,
      "editions": 0.85
    },
    "openQuestions": [
      "Reach lines were taken from the API reference index and pricing page, not walked endpoint by endpoint",
      "Is there a first-party MCP server on the juspay org (none seen in the README)"
    ],
    "sources": [
      {
        "url": "https://github.com/juspay/hyperswitch",
        "foundBy": "sourcing:invoicing-finance:curated"
      },
      {
        "url": "https://hyperswitch.io/pricing",
        "foundBy": "analysis:invoicing-finance"
      },
      {
        "url": "https://api-reference.hyperswitch.io/",
        "foundBy": "sourcing:invoicing-finance:curated"
      }
    ],
    "research": {
      "stage": "verified",
      "verdict": "unverified",
      "reason": "Both capabilities at 3: permissive, owner-documented TOML config, official API and SDKs. Curator note: this is payments infrastructure rather than an SMB app; the paid add-ons cap Reach.",
      "disputed": []
    },
    "url": "apps/juspay--hyperswitch.html",
    "coverage": "partial",
    "paid": false,
    "source": "research/verified/juspay--hyperswitch.json"
  }
}
