[opensourcedex]

Hyperswitch is a free, open source finance & fintech project written in Rust and released under Apache-2.0. It has 45,660 GitHub stars, 6,628 forks and 2,185 open issues, and was last pushed 7 hours ago. On this registry it ranks #2 of 7 tracked projects in Finance & Fintech, with 5 head-to-head comparisons available. It gained 392 stars over the last 30 tracked days.

What is Hyperswitch?

What it is

Hyperswitch is an open-source, composable payments infrastructure built in Rust for managing global payment transactions. It operates as a modular platform that abstracts and unifies interactions with multiple payment, payout, fraud, vault, and tokenization providers—including Stripe, Adyen, Braintree, Worldpay, and Checkout.com—while supporting over 120 payment service providers. It lives in the fintech ecosystem and is licensed under Apache-2.0.

Hyperswitch solves the fragmentation and vendor lock-in inherent in traditional payment stacks by decoupling core functions—such as routing, vaulting, reconciliation, and observability—into independent, replaceable modules. This allows businesses to adopt only the capabilities they need, integrate with existing systems, and avoid costly migrations. It also replaces proprietary SaaS tools for cost analytics, revenue recovery, and reconciliation with open-source equivalents.

Key capabilities

  • Intelligent routing to select the optimal payment service provider per transaction based on predicted authorization rates, region, card BIN, and method
  • PCI-compliant vault service for storing cards, tokens, wallets, and bank credentials, with support for bring-your-own-vault integrations (e.g., VGS, TokenEx)
  • Cost observability dashboards to audit, monitor, and optimize payment fees, detect hidden charges, and analyze downgrades
  • Revenue recovery system using configurable retry strategies tuned to BIN, region, payment method, and penalty budgets
  • Reconciliation engine supporting 2-way and 3-way matching with backdated processing and customizable output formats
  • Drop-in widgets for alternate payment methods including PayPal, Apple Pay, Google Pay, Samsung Pay, Pay by Bank, and BNPL providers like Klarna
  • Control Center UI for configuring connectors, managing environments, and testing payments without code changes

Who uses it and how

  • Payment processors and acquirers embed Hyperswitch to offer unified APIs to merchants while retaining control over routing logic and connector selection
  • Fintechs and SaaS platforms integrate Hyperswitch modules (e.g., vault, routing) into their existing stacks to reduce reliance on multiple point solutions
  • Enterprises with complex multi-connector setups use reconciliation and observability modules to automate operations and reduce manual effort in audit and cost tracking

Getting started

Deploy locally using Docker via git clone --depth 1 --branch latest https://github.com/juspay/hyperswitch && cd hyperswitch && scripts/setup.sh, which supports Standard, Full, and Minimal deployment profiles. A fully hosted sandbox environment is available at no setup cost for testing and exploration.

When to use it — and when not to

Hyperswitch replaces paid SaaS tools for routing, vaulting, and reconciliation but requires self-hosting infrastructure (PostgreSQL, Redis, S3-compatible storage, and optionally SMTP) for full functionality. It trades simplicity for flexibility—ideal when fine-grained control over payment logic is needed—but adds operational overhead compared to fully managed gateways. Avoid if you require out-of-the-box fraud detection or need to avoid infrastructure management entirely.

project readme (upstream, from github) — read inline

Composable Open-Source Payments Infrastructure

Quickstart demo

📁 Table of Contents

What Can I Do with Hyperswitch?

Hyperswitch offers a modular, open-source payments infrastructure designed for flexibility and control. Apart from our Payment Suite offering, this solution allows businesses to pick and integrate only the modules they need on top of their existing payment stack — without unnecessary complexity or vendor lock-in.

Each module is independent and purpose-built to optimize different aspects of payment processing.

Learn More About The Payment Modules

  • Cost Observability
    Advanced observability tools to audit, monitor, and optimize your payment costs. Detect hidden fees, downgrades, and penalties with self-serve dashboards and actionable insights.
    Read more

  • Revenue Recovery
    Combat passive churn with intelligent retry strategies tuned by card bin, region, method, and more. Offers fine-grained control over retry algorithms, penalty budgets, and recovery transparency.
    Read more

  • Vault
    A PCI-compliant vault service to store cards, tokens, wallets, and bank credentials. Provides a unified, secure, and reusable store of customer-linked payment methods. Also supports bring-your-own-vault to connect existing providers including VGS and TokenEx without re-tokenizing or migrating stored cards.
    Read more

  • Intelligent Routing
    Route each transaction across Stripe, Adyen, Braintree, Worldpay, Checkout.com, and 120+ others to the PSP with the highest predicted auth rate. Reduce retries, avoid downtime, and minimize latency while maximizing first attempt success. Read more

  • Reconciliation
    Automate 2-way and 3-way reconciliation with backdated support, staggered scheduling, and customizable outputs. Reduces manual ops effort and increases audit confidence.
    Read more

  • Alternate Payment Methods
    Drop-in widgets for PayPal, Apple Pay, Google Pay, Samsung Pay, Pay by Bank, and BNPL providers like Klarna. Maximizes conversions with seamless one-click checkout.
    Read more

Quickstart

Local Setup via Docker 

# One-click local setup

git clone --depth 1 --branch latest https://github.com/juspay/hyperswitch

cd hyperswitch

scripts/setup.sh
This script:
  • Detects Docker/Podman
  • Offers multiple deployment profiles:
    • Standard: App server + Control Center
    • Full: Includes monitoring + schedulers
    • Minimal: Standalone App server
  • Provides access links when done

If you need further help, check out our video tutorial.

👉 After setup, configure a connector and test a payment.

Hosted Sandbox (No Setup Required)

Hyperswitch offers a fully hosted sandbox environment that requires no setup. You can explore the Control Center, configure payment connectors, and test payments directly from the UI.

What you can do in the Hosted Sandbox
  • Access the full Control Center
  • Configure payment connectors
  • View logs, routing rules, and retry strategies
  • Try payments directly from the UI

Cloud Deployment

You can deploy to AWS, GCP, or Azure using Helm Charts.

Cloud Deployment Instructions.

Architectural Overview

Why Hyperswitch?

Hyperswitch is a commercial open-source payments stack purpose-built for scale, flexibility, and developer experience. Designed with a modular architecture, Hyperswitch lets you pick only the components you need—whether it’s routing, retries, vaulting, or observability—without vendor lock-in or bloated integrations.

Built in Rust for performance and reliability, Hyperswitch connects to Stripe, Adyen, Braintree, Worldpay, Checkout.com, Cybersource, and 120+ processors — exposing smart routing and retry logic, and provides a visual workflow builder in the Control Center. Whether you're integrating a full payment suite or augmenting an existing stack with a single module, Hyperswitch meets you where you are.

Common starting points: teams moving from a single Stripe/ Stripe connect or Braintree integration to multi-PSP routing, merchants replacing a payment gateway with direct acquirer connections to TSYS, JP Morgan Payments, or other acquirers, and merchants rearchitecting their payments platform through Hyperswitch while keeping their existing VGS, TokenEx or other existing vault intact.

“Linux for Payments” — Hyperswitch is a well-architected reference for teams who want to own their payments stack.

We believe in:

  • Embracing Payment Diversity: Innovation comes from enabling choice—across payment methods, processors, and flows.

  • Open Source by Default: Transparency drives trust and builds better, reusable software.

  • Community-Driven Development: Our roadmap is shaped by real-world use cases and contributors.

  • Systems-Level Engineering: We hold ourselves to a high bar for reliability, security, and performance.

  • Maximizing Value Creation: For developers, customers, and partners alike.

  • Community-Driven, Enterprise-Tested: Hyperswitch is built in the open with real-world feedback from developers and contributors, and maintained by Juspay, the team powering payment infrastructure for 400+ leading enterprises worldwide.

Supported Connectors

Hyperswitch integrates with 100+ payment processors out of the box. Each connector has a dedicated guide covering credentials setup, webhook configuration, supported payment methods, and common failure modes.

Processor Type Guide
Global Payments Payment Gateway View →
Stripe Payment Gateway View →
Paypal Payment Gateway View →
Adyen Payment Gateway View →
Bank of America Payment Gateway View →

👉 Browse all available connectors →

Hyperswitch Ecosystem Mapping

Hyperswitch is built as a set of modular services and SDKs that work together. The Rust app server in this repo is the core, and the repositories below extend it with dashboards, client SDKs, and deployment tooling.

1. Core backend services

The Rust services that process payments. The app server is the center of gravity; the vault and encryption service handle sensitive-data operations alongside it. hyperswitch-prism is a separate, lighter entry point: a unified connector library that can be used directly against payment processors without running the full switch. decision-engine is another standalone service: a routing control plane that selects the best gateway per transaction and can run independently of any orchestrator.

hyperswitch card-vault encryption-service prism decision-engine
Language Rust Rust Rust Rust Rust
Role App server. Routing, retries, vaulting, observability. PCI-compliant card storage. Encryption, decryption, KMS. Unified connector library, 100+ processors. Routing control plane. Rule-based and success-rate gateway selection. Standalone, works with any orchestrator.
Depends on card-vault, encryption-service encryption-service None None None

2. Dashboard

Merchant-facing UIs for configuring connectors, routing, and viewing transactions. Both require the hyperswitch backend to be running.

control-center control-center-embedded
Language ReScript TypeScript
Role Full merchant dashboard. Connectors, routing rules, analytics, API keys. Embeddable Hyperswitch components for partners and merchants surfacing Hyperswitch UI inside their own apps.
Depends on hyperswitch backend hyperswitch backend

3. Web checkout SDKs

How a browser talks to Hyperswitch. hyperswitch-client-core is the shared core, pulled in as a git submodule by every client SDK (web and mobile). hyperswitch-sdk-utils holds shared assets that merchants doing Headless Implementations consume directly.

hyperswitch-web client-core react-hyper-js sdk-utils
Language ReScript ReScript ReScript ReScript
Distribution npm git submodule npm git submodule
Role Primary web SDK. ReScript-built React library for unified checkout. Shared SDK core consumed transitively by every client SDK. Idiomatic React wrapper around the Hyper JS loader. Shared utilities and assets used across client-core and hyperswitch-web.
Depends on hyperswitch backend None hyperswitch-web None

4. Mobile SDKs

Native SDKs for embedding Hyperswitch checkout into mobile apps. All are built on top of hyperswitch-client-core, pulled in as a git submodule.

Android iOS React Native Flutter
Repository hyperswitch-sdk-android hyperswitch-sdk-ios react-native-hyperswitch flutter_hyperswitch
Language Kotlin Swift TypeScript Dart
Distribution Maven CocoaPods (SPM in progress) npm pub.dev
Status Officially supported Officially supported Officially supported Officially supported

[!IMPORTANT] An older repo, hyperswitch-sdk-react-native, is being deprecated and has already been removed from npm. Use react-native-hyperswitch instead.

5. Deployment & infrastructure

Tooling for running Hyperswitch, from local development through production.

hyperswitch-suite hyperswitch-helm
Tooling Terraform (HCL) Helm charts
Role Umbrella full-suite deployment that wires the core, vault, control-center, and web together. Recommended starting point for the full stack. Kubernetes deployments for GCP, Azure, or any K8s-compatible platform.

Contributing

We welcome contributors from around the world to help build Hyperswitch. Whether you're fixing bugs, improving documentation, or adding new features, your help is appreciated.

Please read our contributing guidelines to get started.

Join the conversation on Slack or explore open issues on GitHub.

Feature requests & Bugs

For new product features, enhancements, roadmap discussions, or to share queries and ideas, visit our GitHub Discussions

For reporting a bug, please read the issue guidelines and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

Versioning

Check the CHANGELOG.md file for details.

Copyright and License

This product is licensed under the Apache 2.0 License.

Frequently asked questions

Is Hyperswitch free to use?

Hyperswitch is open source under the Apache-2.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does Hyperswitch do?

Open source payment orchestrator for global transactions

What is Hyperswitch written in?

Hyperswitch is primarily written in Rust. Its source is publicly available at https://github.com/juspay/hyperswitch, and it has 45,660 GitHub stars.