Browse / Invoicing and finance
Hyperswitch
Open-source payments switch that routes across 100+ processors, driven by a REST API and SDKs.
A Rust payments orchestrator from Juspay. You connect Stripe, Adyen, PayPal and other processors once, then create payments, refunds, payouts and routing rules through one API. The Community Edition is Apache-2.0 and self-hosted with Docker or Helm; reconciliation, revenue recovery and cost observability are paid add-ons.
- I am outgrowing a single Stripe integration and want routing and retries across processors without rewriting checkout
- I want my agent to create payment links, refunds and payouts through one API regardless of which processor settles them
- Infrastructure-grade: Postgres, Redis and several services; heavier than an SMB invoicing tool
- Reconciliation, revenue recovery and cost observability are paid add-ons even on self-host
- Card data handling still needs your own PCI scope decisions; the vault is a separate service
Last activity Sep 3, 2026. Fit: adaptable 3, operable 3.
Editions
Self-Host Community Edition · Free open source
- Clone
git clone https://github.com/juspay/hyperswitch - ImageContainer
Self-Host Enterprise Edition · Free closed source
- HostedOpen the hosted app
Hyperswitch Cloud · Free closed source
- HostedOpen the hosted app
Adaptable: what is yours to change
Make it yours
Config only15 things to edit
Run scripts/setup.sh for a Docker profile, then edit the TOML config for server, database, Redis, locker and connector settings; docker-compose exposes DATABASE_URL, REDIS_URL and the API keys the Control Center uses. Processor credentials are added per connector in the Control Center or over the API, not in the repo.
- Env vars
DATABASE_URLREDIS_URLHYPERSWITCH_SERVER_URLHYPERSWITCH_CLIENT_URLHYPERSWITCH_CONTROL_CENTER_URLHYPERSWITCH_PUBLISHABLE_KEYHYPERSWITCH_SECRET_KEYLOG_LEVELSCHEDULER_FLOWSDK_ENV- Config files
config/development.tomlconfig/docker_compose.tomlconfig/config.example.tomlconfig/dashboard.tomldocker-compose.yml- Prompt files
- none
- Accounts you need
- At least one payment processor account, such as Stripe, Adyen, or PayPalHyperswitch Cloud account (Cloud edition only)
Source
- github.com/juspay/hyperswitch
- Apache-2.0 license
- Last commit Sep 3, 2026
- 43,569 stars
Operable: what an agent can drive
Interface
OfficialAPIpublished by the builderremote or local
How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.
Reach
Partial coverage. 8 of 10 jobs reachable through the stated interface.
| Job | Through the interface | Evidence |
|---|---|---|
| Create, confirm and capture payments | Reachable | Payments API in api-reference.hyperswitch.io; core of the app server |
| Refunds and disputes | Reachable | Refunds and Disputes endpoints in API reference |
| Connect payment processors | Reachable | Merchant Connector Account API; also Control Center UI |
| Intelligent routing rules | Reachable | Routing API and decision-engine service; listed as included in all plans on hyperswitch.io/pricing |
| Store cards and payment methods (vault) | Reachable | Customers and Payment Methods API; Vault included in all plans |
| Payouts | Reachable | Payouts API; 'Payout Orchestration' included in all plans |
| Webhooks to your systems | Reachable | Webhook configuration in business profile API |
| Hosted checkout and drop-in widgets | Reachable | Payment Links API; hyperswitch-web SDK for embedding |
| Reconciliation | Not reachable | hyperswitch.io/pricing lists Reconciliation as a paid add-on for Community and Enterprise |
| Revenue recovery and cost observability | Not reachable | hyperswitch.io/pricing lists both as paid add-ons |
Code stack
- Languages
- RustReScriptTypeScript
- Frameworks
- actix-web
- Package manager
- cargo
- Database
- PostgreSQLRedis
- Hosting target
- DockerKubernetes (Helm)AWSGCPAzure
- Built
- Human-written (recorded, never ranked)
Evidence and confidence
| Field | Where it was seen | Confidence |
|---|---|---|
| formFactor | Rust app server exposed as REST API; Control Center is a separate repo (README Ecosystem Mapping) | 90% |
| executionModel | no model at runtime for payments; 'AI-powered cost observability' is a paid add-on outside the open edition | 85% |
| operability | api-reference.hyperswitch.io published by Juspay; official web and mobile SDKs listed in README | 95% |
| effort | config/ directory in repo with development.toml, docker_compose.toml, config.example.toml; docker-compose.yml env keys | 80% |
| editions | hyperswitch.io/pricing: Community free, Enterprise custom, Cloud custom; add-ons listed | 85% |
| active | GitHub pushedAt 2026-09-03; 2,141 open issues at triage | – |
| reach | 75% |
Open questions
- Reach lines were taken from the API reference index and pricing page, not walked endpoint by endpoint
- Is there a first-party MCP server on the juspay org (none seen in the README)
Sources
- github.com/juspay/hyperswitch sourcing:invoicing-finance:curated
- hyperswitch.io/pricing analysis:invoicing-finance
- api-reference.hyperswitch.io/ sourcing:invoicing-finance:curated