The open-source payments switch

Supported Features • What's Included • Deploying Hyperswitch • Suite Compatibility • Join us in building HyperSwitch • Community • Versioning • Copyright and License

---

Hyperswitch Suite is the master repository for the Hyperswitch payments stack. It defines the open-source product bundle — the app server, web client, control center, card vault and WooCommerce plugin — along with the compatible versions of each component. It also hosts the Terraform and Terragrunt modules used to deploy the stack on AWS and GCP.

• For the payment-engine source code, see juspay/hyperswitch.
• For deployment modules and live environments, see the terraform/ tree and the Deploying Hyperswitch section below.

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

Supported Features

Supported Payment Processors and Methods

Hyperswitch integrates with 100+ payment processors out of the box — including Stripe, Adyen, Braintree, Worldpay, Checkout.com, Cybersource and many others — exposing smart routing and retry logic across multiple global payment methods. We continuously add new processors based on their reach and community requests.

You can browse the full list of supported processors, payment methods and capabilities 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.

What's Included?

Hyperswitch is architected as a comprehensive suite comprising multiple components, each housed in separate repositories and open-sourced.

• At its core lies the Hyperswitch app server, serving as the central hub orchestrating various functionalities.
• The suite extends further with the Hyperswitch web client, responsible for collecting payment information from end-users.
• Additionally, the Hyperswitch web client offers seamless integration options, including a dedicated wrapper for WooCommerce merchants known as the Hyperswitch WooCommerce plugin.
• Hyperswitch Vault is the component that is responsible for storing card and other payment method details securely in a PCI compliant manner away from the main app server.
• For merchants, the Hyperswitch Control Center serves as a centralized dashboard, granting access to payment data and analytics.
• Throughout this ecosystem, interaction predominantly occurs with the Hyperswitch app server, facilitating the seamless exchange of payment-related information.

Deploying Hyperswitch

This repository contains the Infrastructure-as-Code (Terraform / Terragrunt) used to deploy Hyperswitch on AWS and GCP.

Key deployment docs:

• terraform/aws/ARCHITECTURE.md — AWS module architecture and dependency graph
• terraform/aws/README.md — AWS step-by-step deployment guide
• terraform/gcp/catalog/README.md — GCP catalog unit skeleton, tag naming and CI
• terraform/aws/live/README.md — how the AWS live layer is organised

Suite Compatibility

The CHANGELOG.md lists each Hyperswitch Suite release and the upstream component releases it is validated against: the Hyperswitch app server, control center, web client, card vault, encryption service and WooCommerce plugin. The suite release tag (e.g. v1.21) is the compatibility anchor; the individual application images and Helm values are managed in the GitOps layer (ArgoCD/Helm) outside this repository.

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 it as per their specific requirements.

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.

Contributing

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 ten 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. We appreciate all types of contributions: code, documentation, demo creation, or some new way you want to contribute to us.

Community

Get updates on Hyperswitch development and chat with the community:

• Discord server for questions related to contributing to hyperswitch, questions about the architecture, components, etc.
• Slack workspace for questions related to integrating hyperswitch, integrating a connector in hyperswitch, etc.
• GitHub Discussions to drop feature requests or suggest anything payments-related you need for your stack.

Versioning

Check the CHANGELOG.md file for suite releases and the compatible upstream component versions.

Copyright and License

This product is licensed under the Apache 2.0 License.