Page cover

compassExploration Guide

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:

  • Quickly install Hyperswitch with minimal setup

  • Try your first hello world by making a payment

  • Learn about Hyperswitch’s modular architecture

  • Improve and streamline your checkout experience

  • See how Hyperswitch embeds security, reliability, and scalability into its core architecture


Try Hyperswitch Quickly

Get a Sandbox Ready in under 10 Minutes

Spin up a working integration with minimal effort. Choose the path that fits your needs:

chevron-rightCloud Sandbox (Hyperswitch Hosted Test Environment)hashtag

Try Hyperswitch → Launch a ready-to-use Control Center test environment. No setup required, just log in and run your first transaction.

chevron-rightLocal Deployment (Docker)hashtag

Set up Docker Locally → Perfect for developers who want local control and flexibility. You'll launch a ready-to-use Control Center environment.

chevron-rightAPI-first Integrationhashtag

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 Sandboxarrow-up-right • or your Docker setuparrow-up-right

chevron-rightLaunch a Scalable Hyperswitch Instance on AWShashtag

AWS Deployment →

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.

chevron-rightScalable, Self-Hosted Deployment | Helm Charts for GCP & Azurehashtag

Deploy on GCP or Azure →

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.

Your first payment

See Hyperswitch in action by sending your first test transaction via the cloud sandbox, local Docker setup or directly via API.

chevron-rightTest a payment | Your First Hello World with Hyperswitchhashtag

Control Center | Accessible through cloud sandbox or Docker

API | Accessible through the Postman Collection

Learn how the SDK, control center and backend work together

Hyperswitch Capabilities Overview

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.

chevron-rightPower Only What You Need with Hyperswitch’s Modular Architecturehashtag

Intelligent Routing →arrow-up-right

Dynamically route transactions based on geography, cost, or success rate to reduce failures and fees.

Revenue Recovery →arrow-up-right

Recover failed payments using machine learning–based retry logic that adapts to card network behavior.

Vault (Tokenization) →arrow-up-right

Securely store and reuse payment credentials across providers — ideal for subscriptions and saved cards.

Cost Observability →arrow-up-right

Gain real-time visibility into your processing costs and optimize spend across processors.

Reconciliation →arrow-up-right

Automatically match transaction data across banks, PSPs, and internal systems to reduce manual effort.

3DS Decision Manager →arrow-up-right

Apply 3DS only when necessary, minimizing friction while keeping fraud under control.

Payment Orchestration →arrow-up-right

Automate disbursements to vendors or sellers with rule-based routing logic.

Explore Core Payment Flows and Capabilities

Power only what you need with Hyperswitch’s modular architecture. Integrate just the components that solve your payment challenges, without the extra overhead.

chevron-rightBuild Smarter Payment Flowshashtag

Payment Orchestration →

Automate and optimize how payments are routed, authorized, and split across providers with Hyperswitch’s flexible payment orchestration engine.

Tokenization and Card Vault →

Securely store and reuse customer payment credentials across processors to reduce friction and improve retention.

Get Started with Hyperswitch's Vaultarrow-up-right.

Routing →

Control how transactions flow across payment providers with configurable routing logic and fallback options

Intelligent Routing →

Automatically route transactions based on geography, success rate, or cost to maximize authorization rates.

Smart Retries →

Recover failed payments using ML-driven retry strategies optimized for timing, issuer behavior, and card type.

Payouts →

Easily manage and automate disbursements to sellers, vendors, or partners with flexible payout logic.

Subscriptions →

Handle recurring payments seamlessly with built-in support for subscription billing and invoicing.

Split Payments →

Divide transactions between multiple parties or accounts with precision and control.

Improve Your Checkout and Payment Experience

Deliver seamless, flexible, and localized payment flows that drive higher conversion and customer trust.

chevron-rightCreate Seamless Checkout Experiences That Converthashtag

Customizable Checkout SDK (Web) →arrow-up-right Embed a native, responsive checkout experience into your website with full control over styling and flow.

Click to Pay →arrow-up-right Enable frictionless, one-click payments for returning users using wallets and saved cards.

Payment Methods Management →arrow-up-right Dynamically configure and prioritize payment methods based on geography, currency, and user preference.

Alternate Payment Methods (APMs) →arrow-up-right Offer support for UPI, wallets, and local payment options to meet your customers where they are.

Integration Guide Overview →arrow-up-right Explore the full set of tools and options to deliver a branded and consistent payment experience across platforms.

Manage and Monitor Your Payment Operations

Operate at scale with tools to manage accounts, monitor transactions, handle disputes, and apply business rules.

chevron-rightOperate and Monitor Your Payment Stackhashtag

Manage Accounts and Profiles →arrow-up-right Create, manage, and operate across multiple merchant accounts and profiles with full multi-tenancy support.

Analytics and Operations →arrow-up-right Gain real-time visibility into transaction performance, routing behavior, and operational metrics.

Disputes and Chargebacks →arrow-up-right Monitor, respond to, and manage disputes or chargebacks from a centralized operations interface.

Surcharge Management →arrow-up-right Apply dynamic surcharges or convenience fees based on card type, geography, or business logic.

Full Operations Overview →arrow-up-right Explore the complete set of tools available for scaling your payment operations with confidence.

Scalability, Relability, and Security

Take your Hyperswitch integration to production with confidence. Set up environments, secure credentials, monitor performance, and scale seamlessly as your business grows.

chevron-rightExplore Security, Reliability, and Scalabilityhashtag

Build with confidence on an architecture designed for compliance, low-latency scaling, and enterprise-grade uptime.

Security and Compliance →arrow-up-right Protect sensitive data and meet global compliance standards like PCI DSS with secure-by-default components.

Latency →arrow-up-right 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 throughputarrow-up-right

Reliability →arrow-up-right Achieve consistent uptime and resiliency through modular design and built-in fault tolerance.

Here's how Hyperswitch handles idempotency and message orderingarrow-up-right.

Go Live with Hyperswitch

chevron-rightTake Hyperswitch into productionhashtag

How to Go Live with Hyperswitch →arrow-up-right Follow our go-live checklist to launch with confidence — covering setup, credentials, security, and monitoring.

Need Help?


Developer Resources

Last updated

Was this helpful?