https://github.com/juspay/hyperswitch-docs.git
Hyperswitch gives you full control over your payments infrastructure without the complexity of building from scratch. Whether you're validating a prototype or scaling globally, you can get started in minutes.
This guide helps you:
Spin up a working integration with minimal effort. Choose the path that fits your needs:
Try Hyperswitch →\ Launch a ready-to-use Control Center test environment. No setup required, just log in and run your first transaction.
Set up Docker Locally →\ Perfect for developers who want local control and flexibility. You'll launch a ready-to-use Control Center environment.
API Reference →\ Use Postman Collection →\ Build a custom backend integration from scratch.
⚠️ To authenticate API requests, you’ll need a username and password from either:\
• the Cloud Sandbox\
• or your Docker setup
Launch Hyperswitch on your own AWS infrastructure with our step-by-step deployment guide. Ideal for teams looking for flexibility, control, and production-ready scalability.
Install Hyperswitch on your cloud infrastructure using Helm charts for Kubernetes. This method gives you full control over your environment and is ideal for teams deploying on GCP, Azure, or any Kubernetes-compatible platform.
See Hyperswitch in action by sending your first test transaction via the cloud sandbox, local Docker setup or directly via API.
Control Center | Accessible through cloud sandbox or Docker
API | Accessible through the Postman Collection
Learn how the SDK, control center and backend work together
Power only what you need with Hyperswitch’s modular architecture. You can pick and integrate the components that solve your specific payment challenges without unnecessary overhead.
Dynamically route transactions based on geography, cost, or success rate to reduce failures and fees.
Recover failed payments using machine learning–based retry logic that adapts to card network behavior.
Securely store and reuse payment credentials across providers — ideal for subscriptions and saved cards.
Gain real-time visibility into your processing costs and optimize spend across processors.
Automatically match transaction data across banks, PSPs, and internal systems to reduce manual effort.
Apply 3DS only when necessary, minimizing friction while keeping fraud under control.
Automate disbursements to vendors or sellers with rule-based routing logic.
Power only what you need with Hyperswitch’s modular architecture. Integrate just the components that solve your payment challenges, without the extra overhead.
Automate and optimize how payments are routed, authorized, and split across providers with Hyperswitch’s flexible payment orchestration engine.
Securely store and reuse customer payment credentials across processors to reduce friction and improve retention.
Get Started with Hyperswitch's Vault.
Control how transactions flow across payment providers with configurable routing logic and fallback options
Automatically route transactions based on geography, success rate, or cost to maximize authorization rates.
Recover failed payments using ML-driven retry strategies optimized for timing, issuer behavior, and card type.
Easily manage and automate disbursements to sellers, vendors, or partners with flexible payout logic.
Handle recurring payments seamlessly with built-in support for subscription billing and invoicing.
Divide transactions between multiple parties or accounts with precision and control.
Deliver seamless, flexible, and localized payment flows that drive higher conversion and customer trust.
Customizable Checkout SDK (Web) →\ Embed a native, responsive checkout experience into your website with full control over styling and flow.
Click to Pay →\ Enable frictionless, one-click payments for returning users using wallets and saved cards.
Payment Methods Management →\ Dynamically configure and prioritize payment methods based on geography, currency, and user preference.
Alternate Payment Methods (APMs) →\ Offer support for UPI, wallets, and local payment options to meet your customers where they are.
Integration Guide Overview →\ Explore the full set of tools and options to deliver a branded and consistent payment experience across platforms.
Operate at scale with tools to manage accounts, monitor transactions, handle disputes, and apply business rules.
Manage Accounts and Profiles →\ Create, manage, and operate across multiple merchant accounts and profiles with full multi-tenancy support.
Analytics and Operations →\ Gain real-time visibility into transaction performance, routing behavior, and operational metrics.
Disputes and Chargebacks →\ Monitor, respond to, and manage disputes or chargebacks from a centralized operations interface.
Surcharge Management →\ Apply dynamic surcharges or convenience fees based on card type, geography, or business logic.
Full Operations Overview →\ Explore the complete set of tools available for scaling your payment operations with confidence.
Take your Hyperswitch integration to production with confidence. Set up environments, secure credentials, monitor performance, and scale seamlessly as your business grows.
Build with confidence on an architecture designed for compliance, low-latency scaling, and enterprise-grade uptime.
Security and Compliance →\ Protect sensitive data and meet global compliance standards like PCI DSS with secure-by-default components.
Latency →\ Scale effortlessly with a stateless architecture designed to handle high-throughput payment workloads with near-zero overhead.
Here's how Hyperswitch handles horizontal scaling under high throughput
Reliability →\ Achieve consistent uptime and resiliency through modular design and built-in fault tolerance.
Here's how Hyperswitch handles idempotency and message ordering.
How to Go Live with Hyperswitch →\ Follow our go-live checklist to launch with confidence — covering setup, credentials, security, and monitoring.