README

Composable Open-Source Payments Infrastructure


  






  
    
  
  
    
  
  
    
  



  
    
  
  
    
  
  
    
  





📁 Table of Contents

- What Can I Do with Hyperswitch?
- Quickstart (Local Setup)
- Cloud Deployment
- Hosted Sandbox (No Setup Required)
- Why Hyperswitch?
- Architectural Overview
- Our Vision
- Community & Contributions
- Feature Requests & Bugs
- Versioning
- License
- Team Behind Hyperswitch



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 

bash
 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

Discussions

Latest release

1.129.0

 Docker Images

Pull commands for the release images:

- v1.129.0 (with AWS SES support): docker pull docker.juspay.io/juspaydotin/hyperswitch-router:v1.129.0
- v1.129.0-standalone (without AWS SES support): docker pull docker.juspay.io/juspaydotin/hyperswitch-router:v1.129.0-standalone

 Security Updates

This release includes security fixes and hardening across the application and its dependencies. We recommend upgrading to v1.129.0 to benefit from these improvements alongside fixes to payment processing reliability.

- Strengthen authentication, client-secret validatio