Hyperswitch Prism

Hyperswitch Prism: De Universele Connector-Bibliotheek voor Betalingsverwerking

In de complexe wereld van e-commerce en digitale transacties is het integreren van verschillende betaalverwerkers vaak een tijdrovende en foutgevoelige taak. Hyperswitch Prism biedt de oplossing als een stateless, uniforme connector-bibliotheek. Met Hyperswitch Prism kunt u verbinding maken met elke gewenste betaalverwerker via één enkele integratie. Of u nu Stripe, Adyen of Worldpay gebruikt, met Hyperswitch Prism wisselt u van provider met slechts enkele regels code.

Wat is Hyperswitch Prism?

Hyperswitch Prism is een lichtgewicht, developer-vriendelijke betalingsbibliotheek die is voortgekomen uit de uitgebreide ervaring van het Juspay Hyperswitch-team. Het is een extractie van geharde integraties die jarenlang zijn getest en verfijnd binnen het Juspay Hyperswitch-platform, een open-source betalingsplatform dat door toonaangevende ondernemingen wereldwijd wordt gebruikt.

Prism fungeert als een transformatielaag die de diversiteit aan API's, foutcodes en authenticatiemethoden van verschillende processors abstraheert naar één uniform model. Het is ontworpen om de "tribal knowledge" die vaak opgesloten zit in grote enterprise-systemen toegankelijk te maken voor elke ontwikkelaar, zonder de noodzaak van een zware infrastructuur of vendor lock-in.

Waarom zijn integraties met betaalverwerkers zo complex?

Elke betaalverwerker heeft zijn eigen unieke kenmerken:

• Diverse API-structuren en protocollen.
• Variërende foutcodes en afhandelingslogica.
• Verschillende authenticatiemethoden.
• Gedragsverschillen tussen sandbox-omgevingen en productie-omgevingen.

Een kleine fout in de integratie kan grote financiële gevolgen hebben. Hyperswitch Prism elimineert deze risico's door een gestandaardiseerde interface te bieden die voortdurend wordt getest tegen echte scenario's.

Belangrijkste Kenmerken van Hyperswitch Prism

Hyperswitch Prism onderscheidt zich door zijn eenvoud en technische robuustheid. Hier zijn de belangrijkste kenmerken:

• Eén aanvraagschema voor elke betaling: Of u nu een authorize oproep doet naar Stripe of Adyen, de code blijft hetzelfde. Dit vermindert de complexiteit van uw codebase aanzienlijk.
• Stateless architectuur: De bibliotheek slaat geen gegevens op in een database en bewaart geen PII (Personally Identifiable Information). Inloggegevens worden niet gelogd en bestaan alleen tijdens de levensduur van uw HTTP-client.
• PCI-scope reductie: U bepaalt zelf of kaartgegevens door de bibliotheek stromen. U kunt gebruikmaken van de vault van de betaalverwerker of uw eigen PCI-gecertificeerde vault. Prism slaat niets op.
• Type-veilige en idiomatische SDK's: Beschikbaar voor meerdere talen, waaronder Python, Node.js, Java en Rust.
• Brede ondersteuning voor connectoren: Ondersteunt populaire providers zoals Stripe, Adyen, Braintree, Worldpay, Rapyd en vele anderen.

Hoe Hyperswitch Prism te Gebruiken

Het implementeren van Hyperswitch Prism in uw workflow is eenvoudig en vereist minimale configuratie.

Installatie

U kunt de Hyperswitch Prism-bibliotheek installeren met de pakketbeheerder van uw keuze:

Node.js:

npm install hyperswitch-prism

Python:

pip install hyperswitch-prism

Java/Kotlin (pom.xml):

<dependency>
    <groupId>io.hyperswitch</groupId>
    <artifactId>prism</artifactId>
    <version>0.0.4</version>
</dependency>

Een Betaling Uitvoeren

Hier is een voorbeeld van hoe u een betaling autoriseert met de Node.js SDK via Stripe:

import { PaymentClient, types } from 'hyperswitch-prism';

let config = {
    connectorConfig: {
        stripe: {
            apiKey: { value: "sk_test_..." }
        }
    }
}

const client = new PaymentClient(config);
let request = {
    merchantTransactionId: "auth_123",
    amount: {
        minorAmount: 1000, // $10.00
        currency: types.Currency.USD,
    },
    captureMethod: types.CaptureMethod.AUTOMATIC,
    paymentMethod: {
        card: {
            cardNumber: { value: "4111..." },
            cardExpMonth: { value: "12" },
            cardExpYear: { value: "2050" },
            cardCvc: { value: "123" },
            cardHolderName: { value: "Test User" },
        },
    },
    authType: types.AuthenticationType.NO_THREE_DS,
};

let response = await client.authorize(request);

Use Case: Dynamische Routering en Redundantie

Een van de krachtigste toepassingen van Hyperswitch Prism is de mogelijkheid om direct te schakelen tussen betaalproviders op basis van zakelijke logica, zoals valuta of kosten.

Voorbeeld: Gebruik Adyen voor transacties in EUR en Stripe voor transacties in USD.

Door simpelweg de configuratie van de PaymentClient aan te passen, kunt u uw verkeer omleiden zonder de rest van uw betalingslogica te wijzigen. Dit biedt enorme voordelen voor de beschikbaarheid en kostenoptimalisatie van uw platform.

Architectuuroverzicht

De architectuur van Hyperswitch Prism is ontworpen om zo transparant mogelijk te zijn:

1. Uw Applicatie: Verstuurt verzoeken via de SDK.
2. Prism Library: Vertaalt het uniforme schema naar de specifieke API van de provider.
3. Betaalverwerkers: Stripe, Adyen, Braintree, etc. ontvangen de vertaalde verzoeken.

Dit model zorgt ervoor dat u nooit vastzit aan de specifieke implementatiedetails van één enkele provider.

Veelgestelde Vragen (FAQ)

V: Bevat Hyperswitch Prism een ingebouwde vault voor kaartgegevens? A: Nee, dit is een bewuste ontwerpkeuze. U kunt uw eigen vault meenemen of de vault van de betaalverwerker gebruiken. Prism blijft stateless.

V: Ondersteunt Prism automatische retries of slimme routering? A: Prism is uitsluitend een transformatielaag. Geavanceerde logica zoals retries en routeringsregels maken deel uit van het volledige Juspay Hyperswitch-platform.

V: Is Hyperswitch Prism veilig voor PCI-compliance? A: Ja, doordat Prism stateless is en niets logt of opslaat, helpt het bij het verminderen van uw PCI-scope. U houdt de volledige controle over hoe kaartgegevens worden verwerkt.

V: Welke programmeertalen worden ondersteund? A: Momenteel worden Node.js, Python, Java/Kotlin en Rust ondersteund.

V: Werkt Prism ook voor abonnementen of fraude-detectie? A: Op dit moment richt Prism zich primair op betalingen. De ambitie is echter om Prism te laten evolueren naar een volledige stateless commerce-bibliotheek, inclusief ondersteuning voor belastingen en payouts.