hyperswitch - An Open Source Financial Switch to make Payments fast, reliable and affordable

Created at: 2022-10-17 19:18:28
Language: Rust
License: Apache-2.0

HyperSwitch-Logo HyperSwitch-Logo

Unified Payments Switch. Fast. Reliable. Affordable.

Quick Start GuideFast Integration for Stripe UsersSupported FeaturesFAQs
What's IncludedJoin us in building HyperSwitchCommunityBugs and feature requestsVersioningCopyright and License

HyperSwitch is an Open Source Financial Switch to make payments Fast, Reliable and Affordable. It lets you connect with multiple payment processors and route traffic effortlessly, all with a single API integration. Using HyperSwitch, you can:

  • Reduce dependency on a single processor like Stripe or Braintree
  • Reduce Dev effort by 90% to add & maintain integrations
  • Improve success rates with seamless failover and auto-retries
  • Reduce processing fees with smart routing
  • Customize payment flows with full visibility and control
  • Increase business reach with local / alternate payment methods

HyperSwitch is wire-compatible with top processors like Stripe, making it easy to integrate.


Quick Start Guide

Ways to get started with Hyperswitch:

  1. Try it in our Sandbox Environment: Fast and easy to start. No code or setup required in your system, learn more

  1. A simple demo of integrating Hyperswitch with your React App, Try our React Demo App.

  2. Install in your local system: Configurations and setup required in your system. Suitable if you like to customize the core offering, setup guide

Fast Integration for Stripe Users

If you are already using Stripe, integrating with HyperSwitch is fun, fast & easy. Try the steps below to get a feel for how quick the setup is:

  1. Get API keys from our dashboard.
  2. Follow the instructions detailed on our documentation page.

Supported Features

Supported Payment Processors and Methods

As of Apr 2023, we support 30 payment processors and multiple payment methods. In addition, we are continuously integrating new processors based on their reach and community requests. Our target is to support 100+ processors by H2 2023. You can find the latest list of payment processors, supported methods, and features here.

Hosted Version

In addition to all the features of the open-source product, our hosted version provides features and support to manage your payment infrastructure, compliance, analytics, and operations end-to-end:

  • System Performance & Reliability

    • Scalable to support 50000 tps
    • System uptime of up to 99.99%
    • Deployment with very low latency
    • Hosting option with AWS or GCP
  • Value Added Services

    • Compliance Support incl. PCI, GDPR, Card Vault etc
    • Customize the integration or payment experience
    • Control Center with elaborate analytics and reporting
    • Integration with Risk Management Solutions
    • Integration with other platforms like Subscription, E-commerce, Accounting, etc.
  • Enterprise Support

    • 24x7 Email / On-call Support
    • Dedicated Relationship Manager
    • Custom dashboards with deep analytics, alerts, and reporting
    • Expert team to consult and improve business metrics

You can try the hosted version in our sandbox.


Got more more questions? Please refer to our FAQs page.

What's Included

Within the repositories you'll find the following directories and files, logically grouping common assets and providing both compiled and minified variations.


The current setup contains a single repo, which contains the core payment router and the various connector integrations under the src/connector sub-directory.

Files Tree Layout

├── config                       : config files for router. This stores the initial startup config and separate configs can be provided for debug/release builds.
├── crates                       : sub-crates
│   ├── masking                  : making pii information for pci and gdpr compliance
│   ├── router                   : the main crate
│   └── router_derive            : utility macros for the router crate
├── docs                         : hand written documentation
├── examples                     : examples
├── logs                         : logs generated at runtime
├── migrations                   : diesel db setup
├── openapi                      : API definition
├── postman                      : postman scenarios for API
└── target                       : generated files

Join us in building HyperSwitch

Our Belief

Payments should be open, fast, reliable and affordable to serve the billions of people at scale.

Globally payment diversity has been growing at a rapid pace. There are hundreds of payment processors and new payment methods like BNPL, RTP etc. Businesses need to embrace this diversity to increase conversion, reduce cost and improve control. But integrating and maintaining multiple processors needs a lot of dev effort. Why should devs across companies repeat the same work? Why can't it be unified and reused? Hence, HyperSwitch was born to create that reusable core and let companies build and customize on top of it.

Our Values

  1. Embrace Payments Diversity: It will drive innovation in the ecosystem in multiple ways.
  2. Make it Open Source: Increases trust; Improves the quality and reusability of software.
  3. Be Community driven: It enables participatory design and development.
  4. Build it like Systems Software: This sets a high bar for Reliability, Security and Performance SLAs.
  5. Maximize Value Creation: For developers, customers & partners.


This project is being created and maintained by Juspay, South Asia's largest payments orchestrator/switch, processing more than 50 Million transactions per day. The solution has 1Mn+ lines of Haskell code built over 10 years. HyperSwitch leverages our experience in building large-scale, enterprise-grade & frictionless payment solutions. It is built afresh for the global markets as an open-source product in Rust. We are long-term committed to building and making it useful for the community.

The product roadmap is open for the community's feedback. We shall evolve a prioritization process that is open and community-driven. We welcome contributions from the community. Please read through our contributing guidelines. Included are directions for opening issues, coding standards, and notes on development.

Important note for Rust developers: We aim for contributions from the community across a broad range of tracks. Hence, we have prioritized simplicity and code readability over purely idiomatic code. For example, some of the code in core functions (e.g., payments_core) is written to be more readable than pure-idiomatic.


Get updates on HyperSwitch development and chat with the community:

Bugs and feature requests

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.


Check the CHANGELOG.md file for details.

Copyright and License

This product is licensed under the Apache 2.0 License.