Cos'è
Hyperswitch è una piattaforma open-source di orchestrazione e processing dei pagamenti, sviluppata da Juspay, azienda indiana attiva da circa il 2012 nell'infrastruttura di pagamento per grandi enterprise. Rilasciata sotto licenza Apache 2.0, è progettata per fungere da strato intermedio — spesso definito payments switch — tra un'applicazione commerciante e i fornitori di servizi di pagamento (PSP, payment service providers).
Il progetto è scritto prevalentemente in Rust e si propone come alternativa trasparente ai router di pagamento proprietari. Fornisce un'API unificata e un set di SDK per integrare più processori (come Stripe, Adyen, Braintree, Worldpay, Checkout.com, Cybersource, PayPal e altri) senza dover gestire direttamente le singole integrazioni. Il repository principale è pubblicato su GitHub come juspay/hyperswitch e include il backend, la documentazione e gli script di deployment.
Il modello open-source consente a sviluppatori e organizzazioni di ispezionare il codice, personalizzare comportamenti specifici e contribuire all'evoluzione del progetto. La natura modulare permette di adottare l'intero stack o solo i componenti necessari, integrandoli con sistemi esistenti.
Il problema che risolve
I merchant che operano a livello globale devono gestire una frammentazione crescente: molteplici metodi di pagamento, gateway, requisiti normativi, sistemi antifrode e protocolli di autenticazione (3D Secure). Di conseguenza, le aziende si trovano spesso a dipendere da un unico PSP, con rischio di vendor lock-in, costi di transazione poco trasparenti e difficoltà a ottimizzare i tassi di autorizzazione.
Hyperswitch affronta queste criticità offrendo un livello di orchestrazione che:
- standardizza le chiamate verso processori diversi;
- permette di cambiare o aggiungere gateway senza riscrivere il codice di business;
- consente di definire regole di routing, failover e retry in modo centralizzato;
- mantiene la proprietà dello stack pagamenti, ospitabile on-premise o su cloud privato.
Inoltre, riduce il carico di sviluppo e manutenzione quando un'azienda deve supportare nuovi metodi di pagamento o entrare in mercati che richiedono processori locali, evitando di dover ricostruire l'integrazione per ogni singolo fornitore.
Come funziona
L'architettura di Hyperswitch è modulare e basata su servizi distinti che possono essere distribuiti insieme o separatamente:
- App server (hyperswitch): il nucleo in Rust che gestisce autorizzazioni, autenticazione, capture, void, rimborsi, chargeback e integrazioni con provider esterni.
- Card vault: servizio dedicato allo storage PCI-compliant di carte, token e credenziali di pagamento.
- Encryption service: gestisce cifratura, decifratura e integrazione con KMS.
- Prism: libreria unificata di connettori, utilizzabile anche indipendentemente dallo switch completo.
L'interazione con il merchant avviene attraverso:
- API REST unificate per iniziare e gestire transazioni;
- Web SDK (ReScript/React) e SDK nativi per Android, iOS, React Native e Flutter;
- Control Center, un'interfaccia web per configurare connettori, regole di routing, retry e visualizzare analytics.
Il Control Center consente anche a utenti non tecnici di gestire workflow, impostare flag di funzionalità e monitorare lo stato delle transazioni attraverso log e reportistica. Hyperswitch supporta inoltre l'integrazione di vault di terze parti già in uso (ad esempio VGS, TokenEx) senza richiedere necessariamente la migrazione dei token esistenti.
Caratteristiche principali
- Connettività multi-PSP: integrazioni predefinite con oltre cento processori di pagamento, payout, antifrode, tokenizzazione e autenticazione.
- Intelligent routing: regole basate su volume, tasso di successo, regione, metodo di pagamento o condizioni personalizzate per indirizzare ogni transazione verso il provider più conveniente o affidabile.
- Retry e revenue recovery: strategie automatiche di retry in caso di fallimento, con parametri configurabili per ridurre l'abbandono passivo.
- Vault PCI-compliant: storage sicuro dei metodi di pagamento salvati, con supporto al "bring your own vault".
- Alternate Payment Methods (APM): supporto per wallet (Apple Pay, Google Pay, PayPal), BNPL (Klarna), bonifici e altri metodi alternativi.
- Cost observability: dashboard e reportistica per monitorare commissioni, downgrades e costi nascosti.
- Reconciliation: riconciliazione automatica 2-way e 3-way con schedulazione configurabile.
- Deployment flessibile: installazione locale tramite Docker Compose, deployment su Kubernetes con Helm, infrastruttura Terraform per AWS, GCP, Azure, oltre a una sandbox ospitata per test.
Grazie alla separazione dei componenti, è possibile utilizzare Hyperswitch come semplice router API, come vault indipendente oppure come piattaforma di pagamento completa, a seconda delle esigenze.
Casi d'uso concreti
- Merchant in espansione geografica: un e-commerce che entra in nuovi mercati può attivare processori locali attraverso un'unica integrazione, senza modificare il codice del checkout.
- Ottimizzazione del tasso di autorizzazione: aziende che indirizzano dinamicamente le transazioni verso il PSP con le migliori performance per metodo, paese o fascia oraria.
- Riduzione del vendor lock-in: organizzazioni che vogliono conservare la flessibilità di cambiare gateway mantenendo un'API stabile nel tempo.
- Stack pagamenti proprio: fintech, marketplace o piattaforme SaaS che necessitano di self-hosting per motivi di compliance, audit o controllo operativo.
- Test e staging sicuri: team che utilizzano la sandbox ospitata per validare flussi di pagamento prima della messa in produzione.
- Osservabilità dei costi: aziende che vogliono tracciare e ottimizzare le commissioni pagate a diversi provider attraverso un'unica interfaccia.
Punti di forza e limiti
Punti di forza:
- Codice sorgente aperto sotto Apache 2.0, con possibilità di audit e personalizzazione.
- Architettura modulare: si possono adottare solo i componenti necessari.
- Ampia compatibilità con processori e metodi di pagamento.
- Supporto a deployment on-premise e cloud, con opzioni di hosting autonomo.
- Ecosistema di SDK per web e mobile.
- Active development con contributi della community e roadmap pubblica.
Limiti:
- Setup self-hosted non banale: richiede competenze su Docker/Kubernetes, Postgres, Redis e gestione di certificati PCI.
- La compliance PCI-DSS, sebbene supportata da componenti dedicati, resta responsabilità di chi ospita l'infrastruttura.
- Documentazione e maturità della community in continua evoluzione; alcuni connettori o funzionalità avanzate possono richiedere integrazioni custom.
- Per piccoli progetti con un solo PSP, l'overhead architetturale può essere eccessivo rispetto a una integrazione diretta.
- La curva di apprendimento è significativa per team che non hanno esperienza in infrastrutture di pagamento.
Alternative e contesto
Hyperswitch si colloca nel mercato dell'orchestrazione pagamenti, affiancato da soluzioni come Stripe Treasury/Stripe Connect, Adyen Platform, Checkout.com, PayPal Braintree e router proprietari come Spreedly, Gr4vy o Primer. Rispetto a questi, Hyperswitch differisce per il modello open-source e per l'opzione di self-hosting, che offre maggiore controllo ma richiede più investimento operativo.
L'approccio di Hyperswitch è paragonabile, in ambito pagamenti, a quello che progetti come Kubernetes hanno rappresentato per l'orchestrazione dei container: un livello di astrazione aperto e modulare tra l'applicazione e l'infrastruttura sottostante. La scelta di Rust come linguaggio principale riflette l'attenzione a prestazioni, affidabilità e sicurezza, qualità rilevanti in un dominio dove latenza e integrità dei dati sono critiche.
In sintesi
Hyperswitch è una piattaforma open-source di orchestrazione pagamenti che unifica l'accesso a molteplici processori attraverso un'API e un set di SDK comuni. Sviluppata in Rust da Juspay e rilasciata sotto licenza Apache 2.0, si distingue per l'architettura modulare, il supporto al self-hosting e le funzionalità di routing intelligente, retry, vault e observability. È una scelta orientata a team con esigenze di controllo, compliance e flessibilità, che accettano la complessità di gestire un'infrastruttura di pagamento proprietaria. Per organizzazioni più piccole o con un unico gateway, può risultare eccessivo; per merchant globali e piattaforme in crescita, rappresenta invece uno strumento versatile e trasparente.
Risorse
- Repository principale: https://github.com/juspay/hyperswitch
- Documentazione ufficiale: https://docs.hyperswitch.io
- Sito web: https://www.hyperswitch.io
- Control Center: https://github.com/juspay/hyperswitch-control-center
- Web SDK: https://github.com/juspay/hyperswitch-web