Setup & Cloud Functions

Der Setup-Tab ist der erste und wichtigste Schritt bei der Einrichtung der Zahlungsabwicklung. Hier verbindest du deine App mit Firebase und deployest die notwendigen Cloud Functions.

Übersicht

Der Setup-Tab zeigt dir:

• Service Account Status - Ist dein Firebase-Projekt verbunden?
• Cloud Functions Status - Sind die Zahlungsfunktionen deployed?
• Webhook-URLs - Die URLs für Stripe und PayPal Webhooks
• Setup-Checkliste - Dein Fortschritt auf einen Blick

---

Service Account

Was ist ein Service Account?

Ein Service Account ist ein spezieller Zugang zu deinem Firebase-Projekt. Er ermöglicht der BLOCQ App, Zahlungsfunktionen in deinem Namen zu deployen und API-Schlüssel sicher zu speichern.

Status-Anzeige

Status	Bedeutung	Farbe
Bereit	Service Account konfiguriert und validiert	Grün
Nicht validiert	Service Account vorhanden, aber nicht geprüft	Orange
Fehlt	Kein Service Account eingerichtet	Rot

Service Account einrichten

Falls noch kein Service Account vorhanden ist:

1. Tippe auf Service Account einrichten
2. Du wirst zu den Firebase-Einstellungen weitergeleitet
3. Folge den Anweisungen, um einen Service Account zu erstellen
4. Lade die JSON-Datei herunter und importiere sie
5. Der Status sollte nun Bereit anzeigen

Wichtig

Ohne validierten Service Account können keine Cloud Functions deployed werden! Dieser Schritt ist zwingend erforderlich.

---

Cloud Functions

Was sind Cloud Functions?

Cloud Functions sind kleine Programme, die auf Firebase-Servern laufen. Sie verarbeiten Zahlungen sicher im Hintergrund - deine geheimen API-Schlüssel bleiben dabei immer auf dem Server.

Deployed Functions

Nach erfolgreichem Deployment sind folgende Functions verfügbar:

Function	Beschreibung
createPaymentIntent	Erstellt eine Zahlungsanfrage bei Stripe
stripeWebhook	Empfängt Zahlungsbestatigungen von Stripe
createRefund	Erstattet Zahlungen
savePaymentSecrets	Speichert API-Schlüssel sicher
createPayPalOrder	Erstellt eine PayPal-Bestellung
capturePayPalOrder	Bestätigt eine PayPal-Zahlung
paypalWebhook	Empfängt Bestatigungen von PayPal

Cloud Functions deployen

1. Stelle sicher, dass der Service Account bereit ist
2. Tippe auf Functions deployen
3. Warte, bis der Deployment-Prozess abgeschlossen ist (ca. 1-2 Minuten)
4. Bei Erfolg erscheint eine grüne Bestätigung
5. Die Webhook-URLs werden nun angezeigt

Status-Anzeige

Status	Bedeutung	Aktion
Cloud Functions aktiv	Alles bereit, Zahlungen möglich	-
Nicht deployed	Functions müssen deployed werden	Tippe auf “Functions deployen”
Deployment läuft	Wird gerade installiert	Warten

Erneut deployen

Falls du Probleme hast, kannst du jederzeit Erneut deployen wählen. Das aktualisiert alle Cloud Functions.

---

Webhook-URLs

Was sind Webhooks?

Webhooks sind Benachrichtigungen, die Stripe und PayPal an deine App senden, wenn eine Zahlung erfolgreich war (oder fehlgeschlagen ist). Ohne Webhooks weiss deine App nicht, ob eine Zahlung durchgegangen ist.

URLs nach Deployment

Nach dem Deployment werden dir zwei URLs angezeigt:

Webhook	URL-Format
Stripe	https://europe-west1-{projektId}.cloudfunctions.net/stripeWebhook
PayPal	https://europe-west1-{projektId}.cloudfunctions.net/paypalWebhook

Webhook bei Stripe einrichten

1. Kopiere die Stripe Webhook URL (Kopiersymbol)
2. Öffne das Stripe Dashboard
3. Klicke auf Endpoint hinzuzufügen
4. Füge die kopierte URL ein
5. Wähle die Events aus:
   • payment_intent.succeeded
   • payment_intent.payment_failed
   • charge.refunded
6. Klicke auf Endpoint hinzufügen
7. Kopiere das Webhook Secret (whsec_…)
8. Gib es im Stripe-Tab des Editors ein

Webhook bei PayPal einrichten

1. Kopiere die PayPal Webhook URL
2. Öffne das PayPal Developer Dashboard
3. Wähle deine App aus
4. Gehe zu Webhooks und klicke auf Add Webhook
5. Füge die kopierte URL ein
6. Wähle die Events aus:
   • PAYMENT.CAPTURE.COMPLETED
   • PAYMENT.CAPTURE.DENIED
   • PAYMENT.CAPTURE.REFUNDED
7. Klicke auf Save

Info

Die Webhook-URLs werden erst nach dem Deployment der Cloud Functions angezeigt.

---

Setup-Checkliste

Am Ende des Setup-Tabs findest du eine Checkliste, die deinen Fortschritt zeigt:

Punkt	Beschreibung
Service Account konfiguriert	Service Account ist eingerichtet und validiert
Cloud Functions deployed	Alle Payment Functions sind installiert
Zahlungsanbieter aktiviert	Mindestens Stripe oder PayPal ist aktiv
API Keys konfiguriert	Die geheimen Schlüssel sind gespeichert

Wenn alle Punkte abgehakt sind, erscheint die Meldung Zahlungen sind bereit!

---

Häufige Probleme

”Service Account nicht validiert”

Lösung: Gehe zu den Firebase-Einstellungen und validiere deinen Service Account erneut. Prüfe, ob die JSON-Datei korrekt importiert wurde.

”Deployment fehlgeschlagen”

Mögliche Ursachen:

• Service Account ist nicht korrekt konfiguriert
• Keine Internetverbindung
• Firebase-Projekt hat nicht genügend Berechtigungen

Lösung: Prüfe den Service Account und versuche es erneut.

”Webhook-URLs werden nicht angezeigt”

Lösung: Die URLs erscheinen erst nach erfolgreichem Deployment der Cloud Functions. Deploye zuerst die Functions.

---

Nächste Schritte

Nach erfolgreichem Setup:

1. Gehe zum Anbieter-Tab und aktiviere Stripe und/oder PayPal
2. Konfiguriere die API-Schlüssel im Stripe- oder PayPal-Tab
3. Richte die Webhooks bei Stripe/PayPal ein (siehe oben)
4. Teste eine Zahlung im Testmodus