Hyperswitch Prism
Hyperswitch Prism: Die universelle Open-Source-Bibliothek für nahtlose Zahlungsanbieter-Integrationen und flexibles Routing.
Hyperswitch Prism ist eine zustandslose, vereinheitlichte Connector-Bibliothek von Juspay, die es Entwicklern ermöglicht, jeden Zahlungsanbieter mit einem einzigen Schema zu integrieren. Tauschen Sie Provider wie Stripe oder Adyen mit minimalem Code-Aufwand aus, reduzieren Sie Ihren PCI-Scope und profitieren Sie von einer hochperformanten Rust-basierten Architektur ohne Vendor-Lock-in.
2026-05-14
631004.1K
Hyperswitch Prism Produktinformationen
Hyperswitch Prism: Die ultimative Lösung für die Integration von Zahlungsanbietern
In der heutigen digitalen Wirtschaft ist die Flexibilität im Zahlungsverkehr ein entscheidender Wettbewerbsvorteil. Hyperswitch Prism bietet Entwicklern und Unternehmen eine leistungsstarke, zustandslose und vereinheitlichte Connector-Bibliothek, um eine Verbindung zu jedem beliebigen Zahlungsanbieter (Payment Processor) herzustellen. Das Projekt wurde aus den gehärteten Integrationen von Juspay Hyperswitch extrahiert, einer Plattform, die durch jahrelange Nutzung und kontinuierliche Fehlerbehebung bei führenden Enterprise-Händlern weltweit optimiert wurde.
Mit Hyperswitch Prism gehört die Komplexität proprietärer APIs der Vergangenheit an. Sie erhalten eine einzige Integration, die es Ihnen ermöglicht, Zahlungsdienstleister mit nur wenigen Zeilen Code zu wechseln.
Was ist Hyperswitch Prism?
Hyperswitch Prism ist eine leichtgewichtige, entwicklerfreundliche Zahlungsbibliothek, die als Transformationsschicht zwischen Ihrer Anwendung und verschiedenen Zahlungsanbietern fungiert. Im Gegensatz zu komplexen SaaS-Lösungen ist Prism vollständig zustandslos (stateless). Das bedeutet, dass keine Datenbanken erforderlich sind und keine personenbezogenen Daten (PII) gespeichert oder protokolliert werden.
Die Bibliothek wurde vom Team hinter Juspay Hyperswitch entwickelt – der Open-Source-Zahlungsplattform, die über 40.000 Sterne auf GitHub verzeichnet. Prism extrahiert das geballte Wissen über diverse API-Eigenheiten, Fehlercodes und Authentifizierungsmethoden in eine einfache Schnittstelle.
"Zahlungen sind im Grunde nicht komplizierter als Datenbanktreiber. Das Problem ist lediglich, dass die Branche bisher keinen einheitlichen Standard gefunden hat – und wahrscheinlich auch nie wird."
Die Philosophie von Hyperswitch Prism
Das Ziel von Hyperswitch Prism ist es, die Vielfalt im Zahlungsverkehr für die gesamte Welt zugänglich zu machen. Es dient als Zero-Lock-in-Lösung, die sicherstellt, dass Unternehmen nicht an einen einzigen Anbieter gebunden sind, sondern jederzeit die für sie beste Option wählen können.
Die wichtigsten Funktionen (Features)
Hyperswitch Prism zeichnet sich durch eine Reihe von Kernfunktionen aus, die den Integrationsaufwand drastisch reduzieren:
1. Ein einheitliches Anforderungsschema
Unabhängig davon, ob Sie Stripe, Adyen oder einen anderen Anbieter nutzen, bleibt der Code für den Aufruf der Autorisierung identisch. Ein einziger authorize-Call deckt alle unterstützten Connectoren ab, ohne dass zusätzliche Logik für unterschiedliche API-Strukturen geschrieben werden muss.
2. Vollständige Zustandslosigkeit (Stateless)
Prism speichert keine Daten. Es gibt keine integrierte Datenbank und Zugangsdaten (Credentials) werden weder dauerhaft gespeichert noch geloggt. Die Lebensdauer der Daten ist auf den HTTP-Client-Zyklus begrenzt, was die Sicherheit massiv erhöht.
3. Reduzierung des PCI-Scopes
Sie haben die volle Kontrolle darüber, wie Kartendaten fließen. Hyperswitch Prism erlaubt es Ihnen, entweder den Vault eines Zahlungsanbieters oder Ihren eigenen PCI-zertifizierten Vault zu nutzen. Da die Bibliothek nichts speichert, wird Ihr PCI-Compliance-Aufwand erheblich minimiert.
4. Breite Connector-Unterstützung
Prism unterstützt eine Vielzahl von Connectoren (über 57 in der Testumgebung), die kontinuierlich gegen echte Sandbox- und Produktionsumgebungen geprüft werden. Der Status der Integrationen wird wie folgt klassifiziert:
- ✓ Unterstützt: Vollständig implementiert und getestet.
- x Nicht unterstützt: Vom Prozessor nicht anwendbar.
- ⚠ In Arbeit: Implementierung läuft oder ist teilweise abgeschlossen.
- ? Validierung erforderlich: Muss noch in einer Live-Umgebung validiert werden.
Warum die Integration von Zahlungsanbietern so komplex ist
Jeder Payment Processor besitzt unterschiedliche APIs, diverse Fehlercodes und variierende Authentifizierungsmethoden. Oft weichen die tatsächlichen Verhaltensweisen der Produktivumgebung von den dokumentierten Spezifikationen in PDF-Dokumenten ab.
Kleine Fehler bei der Integration können fatale finanzielle Folgen für Unternehmen haben. Das Wissen über diese Fallstricke ist oft als "Tribal Knowledge" in großen Enterprise-Plattformen gefangen. Hyperswitch Prism bricht dieses Silo auf und stellt dieses Wissen als Open-Source-Bibliothek zur Verfügung.
Wie man Hyperswitch Prism verwendet (How to Use)
Die Integration von Hyperswitch Prism ist so konzipiert, dass sie innerhalb weniger Minuten in bestehende Projekte übernommen werden kann.
Schritt 1: Installation
Wählen Sie die Bibliothek für Ihre bevorzugte Programmiersprache:
Node.js
npm install hyperswitch-prism
Python
pip install hyperswitch-prism
Java / Kotlin
Fügen Sie die Dependency in Ihre pom.xml ein:
<dependency>
<groupId>io.hyperswitch</groupId>
<artifactId>prism</artifactId>
<version>0.0.4</version>
</dependency>
Schritt 2: Eine Zahlung durchführen
Hier ist ein Beispiel für eine Autorisierung mit Node.js:
import { PaymentClient, types } from 'hyperswitch-prism';
let config = {
connectorConfig: {
stripe: { apiKey: { value: "sk_test_..." } }
}
};
const main = async () => {
let client = new PaymentClient(config);
let request = {
merchantTransactionId: "auth_123",
amount: { minorAmount: 1000, currency: types.Currency.USD },
captureMethod: types.CaptureMethod.AUTOMATIC,
paymentMethod: {
card: {
cardNumber: { value: "4111111111111111" },
cardExpMonth: { value: "12" },
cardExpYear: { value: "2050" },
cardCvc: { value: "123" },
cardHolderName: { value: "Test User" },
},
},
authType: types.AuthenticationType.NO_THREE_DS,
address: {},
orderDetails: [],
};
let response = await client.authorize(request);
if (response.status === types.PaymentStatus.CHARGED) {
console.log("Erfolg");
}
};
main();
Schritt 3: KI-Unterstützung nutzen
Wenn Sie mit KI-Assistenten bauen, können Sie die vollständige SDK-Referenz via curl abrufen:
curl -fsSL https://raw.githubusercontent.com/juspay/hyperswitch-prism/main/llm/llm.txt
Anwendungsfall: Dynamisches Routing (Use Case)
Der größte Vorteil von Hyperswitch Prism ist der einfache Wechsel zwischen Providern basierend auf Geschäftsregeln.
Beispiel-Szenario: Sie möchten Zahlungen in EUR über Adyen abwickeln und Zahlungen in USD über Stripe.
const currency = types.Currency.USD;
const config = currency === types.Currency.EUR ? adyenConfig : stripeConfig;
const client = new PaymentClient(config);
// Der restliche Autorisierungscode bleibt identisch!
Durch diese einfache Logik können Sie intelligente Retry-Mechanismen implementieren und Ihre Konversionsraten durch die Nutzung des jeweils besten Providers pro Region oder Währung optimieren.
Was Prism (noch) nicht leistet
Es ist wichtig zu verstehen, dass Prism eine reine Transformationsschicht ist:
- Kein integrierter Vault: Prism bietet keinen Tokenisierungsservice. Sie müssen Ihren eigenen Vault oder den des Prozessors nutzen.
- Keine Routing-Logik: Die Entscheidungslogik für Retries oder Smart Routing liegt in der Hauptanwendung (oder in Juspay Hyperswitch).
- Fokus auf Zahlungen: Aktuell liegt der Fokus auf Zahlungen. Erweiterungen für Abonnements, Betrugsprävention und Steuern sind für die Zukunft geplant.
Technische Details und Architektur
Die Architektur von Hyperswitch Prism ist darauf ausgelegt, als idiomatische Schnittstelle zwischen Ihrer App und den Prozessoren zu fungieren. Die Kernlogik ist in Rust geschrieben (88,1%), was für außergewöhnliche Performance und Sicherheit sorgt.
Unterstützte Plattformen:
- macOS (Apple Silicon): arm64
- Linux: x86_64
FAQ (Häufig gestellte Fragen)
F: Ist Hyperswitch Prism kostenlos? A: Ja, es ist ein Open-Source-Projekt unter der Apache-2.0 Lizenz.
F: Speichert die Bibliothek meine API-Keys? A: Nein, Prism ist vollkommen zustandslos. Die Keys existieren nur während der Laufzeit Ihres HTTP-Requests.
F: Kann ich Prism mit KI-Tools wie ChatGPT nutzen? A: Ja, es gibt eine spezielle Dokumentationsdatei für LLMs, die alle SDK-Details enthält und einfach eingelesen werden kann.
F: Wer wartet Hyperswitch Prism? A: Die Bibliothek wird vom Team bei Juspay entwickelt und gepflegt, den Machern der Hyperswitch-Zahlungsplattform.
F: Welche Sprachen werden unterstützt? A: Aktuell stehen SDKs für Node.js, Python, Java/Kotlin und Rust zur Verfügung.
