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.

Uebersicht

Der Setup-Tab zeigt dir:

• Service Account Status - Ist dein Firebase-Projekt verbunden?
• Cloud Functions Status - Sind die Zahlungsfunktionen deployed?
• Webhook-URLs - Die URLs fuer 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 ermoeglicht der BLOCQ App, Zahlungsfunktionen in deinem Namen zu deployen und API-Schluessel sicher zu speichern.

Status-Anzeige

Status	Bedeutung	Farbe
Bereit	Service Account konfiguriert und validiert	Gruen
Nicht validiert	Service Account vorhanden, aber nicht geprueft	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 koennen 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-Schluessel bleiben dabei immer auf dem Server.

Deployed Functions

Nach erfolgreichem Deployment sind folgende Functions verfuegbar:

Function	Beschreibung
createPaymentIntent	Erstellt eine Zahlungsanfrage bei Stripe
stripeWebhook	Empfaengt Zahlungsbestatigungen von Stripe
createRefund	Erstattet Zahlungen
savePaymentSecrets	Speichert API-Schluessel sicher
createPayPalOrder	Erstellt eine PayPal-Bestellung
capturePayPalOrder	Bestaetigt eine PayPal-Zahlung
paypalWebhook	Empfaengt 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 gruene Bestaetigung
5. Die Webhook-URLs werden nun angezeigt

Status-Anzeige

Status	Bedeutung	Aktion
Cloud Functions aktiv	Alles bereit, Zahlungen moeglich	-
Nicht deployed	Functions muessen deployed werden	Tippe auf “Functions deployen”
Deployment laeuft	Wird gerade installiert	Warten

Erneut deployen

Falls du Probleme hast, kannst du jederzeit Erneut deployen waehlen. 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. Oeffne das Stripe Dashboard
3. Klicke auf Endpoint hinzuefuegen
4. Fuege die kopierte URL ein
5. Waehle die Events aus:
   • payment_intent.succeeded
   • payment_intent.payment_failed
   • charge.refunded
6. Klicke auf Endpoint hinzufuegen
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. Oeffne das PayPal Developer Dashboard
3. Waehle deine App aus
4. Gehe zu Webhooks und klicke auf Add Webhook
5. Fuege die kopierte URL ein
6. Waehle 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 Schluessel sind gespeichert

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

---

Haeufige Probleme

”Service Account nicht validiert”

Loesung: Gehe zu den Firebase-Einstellungen und validiere deinen Service Account erneut. Pruefe, ob die JSON-Datei korrekt importiert wurde.

”Deployment fehlgeschlagen”

Moegliche Ursachen:

• Service Account ist nicht korrekt konfiguriert
• Keine Internetverbindung
• Firebase-Projekt hat nicht genuegend Berechtigungen

Loesung: Pruefe den Service Account und versuche es erneut.

”Webhook-URLs werden nicht angezeigt”

Loesung: Die URLs erscheinen erst nach erfolgreichem Deployment der Cloud Functions. Deploye zuerst die Functions.

---

Naechste Schritte

Nach erfolgreichem Setup:

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