
Hyperswitch: piattaforma open-source di orchestrazione pagamenti
Stack modulare in Rust per connettere più processori di pagamento, gestire routing, retry e vault in modo trasparente e senza vendor lock-in.
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.