Stripe-Zahlungen automatisieren

In diesem Artikel zeige ich Ihnen, wie die technische Integration zwischen Stripe und BuchhaltGenie funktioniert. Wenn Ihr Kunde über einen Payment Link bezahlt, wird die Rechnung automatisch als bezahlt markiert - ohne dass Sie einen Finger rühren musst.

Wie funktioniert die Integration?

Die Verbindung zwischen Stripe und BuchhaltGenie basiert auf drei Komponenten:

Der Ablauf im Detail

┌─────────────────────────────────────────────────────────────────┐
│  1. Sie erstellst Rechnung mit Online-Zahlung                    │
│     ↓                                                          │
│  2. BuchhaltGenie erstellt Stripe Invoice                      │
│     ↓                                                          │
│  3. Kunde erhält Payment Link per E-Mail                       │
│     ↓                                                          │
│  4. Kunde bezahlt über sichere Stripe-Seite                    │
│     ↓                                                          │
│  5. Stripe sendet Webhook an BuchhaltGenie                     │
│     ↓                                                          │
│  6. Rechnung wird automatisch auf "Bezahlt" gesetzt            │
│     ↓                                                          │
│  7. Buchungssatz wird erstellt (Soll: Bank, Haben: Forderungen)│
└─────────────────────────────────────────────────────────────────┘

Stripe Invoice erstellen

Wenn Sie eine Rechnung mit Online-Zahlung versendest, erstellt BuchhaltGenie im Hintergrund eine Stripe Invoice:

Webhook-System verstehen

Was ist ein Webhook?

Ein Webhook ist eine automatische HTTP-Benachrichtigung, die Stripe an BuchhaltGenie sendet, sobald etwas passiert - zum Beispiel wenn ein Kunde bezahlt.

Unterstützte Webhook-Events

Technische Sicherheit

Die Webhook-Kommunikation ist mehrfach abgesichert:

• Signaturverifikation: Jeder Webhook wird kryptografisch signiert
• HTTPS-only: Verschlüsselte Übertragung
• Idempotenz: Duplikate werden automatisch erkannt und ignoriert
• Audit-Logging: Jedes Event wird für 7 Jahre protokolliert (BAO §132)

Automatische Zahlungsbuchung

Wenn die Zahlung erfolgreich ist, erstellt BuchhaltGenie automatisch den passenden Buchungssatz:

Buchungsbeispiel

Rechnung RE-2026-00123 über EUR 1.190,00 (inkl. 20% USt)

Stripe-Gebühren buchen

Die Stripe-Gebühren (3%) werden separat gebucht:

Netto-Eingang auf Ihrem Bankkonto: EUR 1.154,30

Fehlerbehebung

Zahlung erfolgt, aber Rechnung nicht aktualisiert?

In seltenen Fällen kann es zu Verzögerungen kommen:

Compliance und Audit-Trail

BAO §132 - Aufbewahrungspflicht

Alle Stripe-Transaktionen werden 7 Jahre aufbewahrt:

UStG §11 - Rechnungsanforderungen

Die Stripe-Integration ändert nichts an den gesetzlichen Anforderungen:

• Alle Pflichtangaben müssen weiterhin auf der Rechnung stehen
• Der Zahlungsweg (Stripe) hat keinen Einfluss auf die Umsatzsteuer
• Das Leistungsdatum bleibt das originale Rechnungsdatum

Technische Details für Entwickler

API-Endpunkt

// Stripe Invoice erstellen
const result = await createStripeInvoiceAction({
  invoiceId: 'uuid-der-internen-rechnung',
  customerEmail: 'kunde@beispiel.at',
  customerName: 'Max Mustermann GmbH',
  description: 'Rechnung RE-2026-00123',
  amountCents: 119000, // EUR 1.190,00
  dueDate: '2026-02-15',
  autoSend: true,
});
 
if (result.success) {
  // result.data.hostedInvoiceUrl = Payment Link
  // result.data.stripeInvoiceId = Stripe Invoice ID
}

Webhook-Handler

Der Webhook-Endpunkt verarbeitet folgende Events:

• invoice.paid → Rechnung als bezahlt markieren
• invoice.payment_failed → Benachrichtigung erstellen
• checkout.session.completed → Subscription aktualisieren

Metadaten-Zuordnung

Jede Stripe Invoice enthält Metadaten für die automatische Zuordnung:

{
  "business_id": "uuid-des-unternehmens",
  "invoice_id": "uuid-der-buchhaltgenie-rechnung",
  "invoice_number": "RE-2026-00123"
}

Häufige Fragen

Kann ich die Stripe-Integration deaktivieren?

Ja, unter Einstellungen → Zahlungen → Stripe trennen. Bestehende Payment Links bleiben aktiv.

Was passiert bei einer Teilzahlung?

Stripe Payment Links unterstützen nur vollständige Zahlungen. Für Teilzahlungen muss der Kunde überweisen.

Werden Rückerstattungen automatisch verbucht?

Ja! Wenn Sie eine Rückerstattung über Stripe auslöst, wird automatisch eine Gegenbuchung erstellt.

Weiterführende Links

• Online-Zahlung einrichten →
• Stripe-Konto verbinden →
• Gutschriften erstellen →