1. Was ist Stripe und warum braucht man es?

Stripe ist die führende Zahlungsplattform, die es Online-Shops, SaaS-Diensten und anderen Webanwendungen ermöglicht, Zahlungen von Kunden weltweit zu akzeptieren. Die offizielle stripe-Bibliothek für Node.js bietet Entwicklern ein vollständiges Toolkit zur Integration der Stripe Payment API in das Backend ihrer Anwendung. Sie abstrahiert die Komplexität direkter HTTP-Anfragen an die Stripe-API und bietet eine benutzerfreundliche, typisierte und vorhersagbare Schnittstelle in JavaScript.

Warum ist diese Bibliothek wichtig? In der modernen Webentwicklung ist die sichere Zahlungsabwicklung eine der kritischsten Aufgaben. Stripe übernimmt die Einhaltung der PCI-DSS-Standards, die Verarbeitung sensibler Daten (Kartennummern, CVV) und die Verwaltung komplexer Szenarien (Abonnements, Rückerstattungen, Streitfälle). Die Node.js-Bibliothek ermöglicht es Ihnen, mühelos Zahlungsformulare zu erstellen, Kunden zu verwalten, Abonnements anzulegen, Webhooks zu verarbeiten und Berichte zu generieren – und das alles mit asynchronem, Promise-basiertem Code.

Dank dieser Bibliothek können Sie sich auf die Geschäftslogik Ihrer Anwendung konzentrieren, anstatt sich mit den Low-Level-Details von Zahlungsprotokollen herumschlagen zu müssen. Sie ist ideal für Node.js-Anwendungen, die mit Express, Koa, Fastify oder einem anderen Framework laufen. Die Bibliothek wird aktiv von Stripe gepflegt, regelmäßig aktualisiert und hat eine riesige Community.

2. Installation

Um die Stripe-Bibliothek in Ihr Node.js-Projekt zu installieren, verwenden Sie den Paketmanager npm oder yarn. Führen Sie einen der folgenden Befehle im Stammverzeichnis Ihres Projekts aus:

# Mit npm
npm install stripe

# Mit yarn
yarn add stripe

Nach der Installation können Sie die Bibliothek in Ihren Code importieren:

// Moderner Syntax (ES Modules)
import Stripe from 'stripe';

// Oder CommonJS (Node.js Standard)
const Stripe = require('stripe');

Wichtig: Für die Arbeit mit der Bibliothek benötigen Sie einen geheimen Schlüssel (sk_test_... für den Testmodus oder sk_live_... für die Produktion). Den Schlüssel erhalten Sie im Stripe-Dashboard.

3. Schnellstart – Minimales funktionierendes Beispiel

Lassen Sie uns ein einfaches Skript erstellen, das eine Zahlungsabsicht (PaymentIntent) erzeugt – die Standardmethode, um eine einmalige Zahlung zu akzeptieren.

// Bibliothek importieren
const Stripe = require('stripe');
// Mit dem geheimen Schlüssel initialisieren (durch Ihren Testschlüssel ersetzen)
const stripe = Stripe('sk_test_XXXXXXXXXXXXXXXXXXXXXXXX');

async function createPayment() {
    try {
        // Erstellen eines PaymentIntent über 2000 Cent (20 EUR)
        const paymentIntent = await stripe.paymentIntents.create({
            amount: 2000,
            currency: 'eur',
            // Zahlungsbeschreibung (optional)
            description: 'Testzahlung aus Node.js',
            // Zahlung automatisch erfassen (true) oder nur autorisieren (false)
            capture_method: 'automatic',
        });

        console.log('PaymentIntent erfolgreich erstellt:');
        console.log(`ID: ${paymentIntent.id}`);
        console.log(`Status: ${paymentIntent.status}`);
        console.log(`Betrag: ${paymentIntent.amount} ${paymentIntent.currency.toUpperCase()}`);
    } catch (error) {
        console.error('Fehler beim Erstellen des PaymentIntent:', error.message);
    }
}

createPayment();

Dieser Code