Zahlungsanbieter einrichten

Im zweiten Schritt des Zahlungen-Setups richtest du die Zahlungsanbieter ein. Der Wizard führt dich durch die automatische Einrichtung mit Cloud Functions.

Übersicht

Die Zahlungsanbieter-Einrichtung umfasst:

Cloud Functions

Serverlose Zahlungsverarbeitung deployen.

Stripe

Kreditkarten, Apple Pay, Google Pay.

PayPal

PayPal-Konten und Guthaben.

Sichere Speicherung

API-Schlüssel verschlüsselt speichern.

---

Was du im Setup siehst

Der Zahlungsanbieter-Schritt zeigt dir:

1. Titel: „Zahlungsanbieter einrichten”

2. Eine Info-Box mit der Beschreibung: „Richten Sie Stripe und PayPal ein, um Zahlungen zu akzeptieren.”

3. Einen „Einrichtungsassistent starten”-Button

4. Eine Skip-Option zum späteren Einrichten

---

Der Einrichtungsassistent

Der Wizard führt dich durch vier Schritte:

1. Einführung

   Übersicht über die Online-Zahlungsmöglichkeiten.

   Features im Überblick:

   • Kreditkarten (Visa, Mastercard, etc.)
   • Apple Pay auf iOS-Geräten
   • Google Pay auf Android-Geräten
   • PayPal-Konten und -Guthaben
   • Sichere Zahlungsabwicklung

2. Automatische Einrichtung

   Mit einem Klick werden alle benötigten Services eingerichtet.

   Was wird eingerichtet:

   • Zahlungsverarbeitung im Hintergrund (Cloud Functions)
   • Stripe für Kreditkarten & Apple/Google Pay
   • PayPal-Integration
   • Sichere Speicherung der API-Schlüssel

3. Zahlungsanbieter wählen

   Aktiviere die Zahlungsmethoden, die du akzeptieren möchtest.

   Anbieter	Beschreibung
   Stripe	Kreditkarten, Apple Pay, Google Pay
   PayPal	PayPal-Konto und Guthaben

4. API-Schlüssel eingeben

   Gib die Schlüssel deiner gewählten Zahlungsanbieter ein.

   Sichere Speicherung

   Deine Schlüssel werden sicher verschlüsselt in Firebase gespeichert.

---

Automatisches Setup

Mit Service Account (empfohlen)

Automatische Einrichtung mit Service Account

Eigenschaft	Beschreibung
Voraussetzung	Service Account konfiguriert und validiert
Dauer	ca. 30-60 Sekunden
Aufwand	Minimal (ein Klick)
Empfohlen für	Alle Nutzer

So funktioniert’s:

1. Tippe auf „Automatisch einrichten”
2. Die Cloud Functions werden deployt
3. Erfolgsmeldung: „Alles wurde erfolgreich eingerichtet!”
4. Fahre mit der Anbieter-Auswahl fort

Was wird deployt:

• Payment Intent Erstellung
• Webhook-Handler für Zahlungsstatus
• Sichere Schlüsselverwaltung
• Rückerstattungs-Funktionen

Service Account erforderlich

Für das automatische Setup benötigst du einen konfigurierten Service Account. 👉 Service Account einrichten

Ohne Service Account

Manuelles Setup

Eigenschaft	Beschreibung
Voraussetzung	Keine
Dauer	Variabel
Aufwand	Höher

Wenn kein Service Account konfiguriert ist:

1. Du siehst die Meldung: „Für die automatische Einrichtung muss zuerst ein Service Account erstellt werden.”
2. Du kannst:
   • Service Account einrichten - Wird empfohlen
   • Überspringen - API-Schlüssel später im Editor eingeben

Eingeschränkte Funktionalität

Ohne Cloud Functions können Zahlungen nicht vollständig verarbeitet werden. Das automatische Setup wird dringend empfohlen.

---

Anbieter-Auswahl

Nach dem erfolgreichen Setup wählst du die Zahlungsanbieter:

Stripe

Stripe aktivieren

Option	Beschreibung
Stripe aktivieren	Hauptschalter für Stripe
Beschreibung	„Kreditkarten, Apple Pay, Google Pay”

Stripe ermöglicht:

• Kreditkartenzahlungen (Visa, Mastercard, American Express)
• Apple Pay (automatisch auf iOS)
• Google Pay (automatisch auf Android)

Empfohlen

Stripe ist der empfohlene Zahlungsanbieter für die meisten Anwendungsfälle.

PayPal

PayPal aktivieren

Option	Beschreibung
PayPal aktivieren	Hauptschalter für PayPal
Beschreibung	„PayPal-Konto und Guthaben”

PayPal ermöglicht:

• Zahlung über PayPal-Konto
• Zahlung mit PayPal-Guthaben
• Käuferschutz für Kunden

Zusätzliche Reichweite

PayPal erreicht Kunden, die keine Kreditkarte nutzen möchten.

---

API-Schlüssel eingeben

Je nach gewähltem Anbieter gibst du die entsprechenden Schlüssel ein:

Stripe-Schlüssel

Stripe API-Schlüssel

Schlüssel	Beschreibung
Publishable Key	Öffentlicher Schlüssel (beginnt mit pk_)
Secret Key	Geheimer Schlüssel (beginnt mit sk_)

So findest du die Schlüssel:

1. Melde dich bei dashboard.stripe.com an
2. Öffne die API-Keys-Seite direkt unter dashboard.stripe.com/apikeys (früher über das Menü „Developers”; neue Konten nutzen „Workbench”)
3. Kopiere den Publishable Key und Secret Key. Der Publishable Key ist immer sichtbar; der Live-Secret-Key wird nur einmal angezeigt – sofort sicher speichern

Test- vs. Live-Schlüssel

• Test-Schlüssel beginnen mit pk_test_ / sk_test_
• Live-Schlüssel beginnen mit pk_live_ / sk_live_
• Zusätzlich gibt es eingeschränkte Schlüssel (rk_test_ / rk_live_)

Schalte das Dashboard von Test/Sandbox auf Live-Modus um, damit die pk_live_/sk_live_-Schlüssel angezeigt werden. Verwende für Tests immer die Test-Schlüssel!

Optionale Schlüssel (im Editor):

Schlüssel	Beschreibung
Webhook Secret	Für Echtzeit-Statusupdates
Apple Merchant ID	Für Apple Pay

PayPal-Schlüssel

PayPal API-Zugangsdaten

Schlüssel	Beschreibung
Client ID	Öffentliche Client-ID
Client Secret	Geheimes Client-Secret

So findest du die Zugangsdaten:

1. Melde dich bei developer.paypal.com an
2. Gehe zu „My Apps & Credentials”
3. Erstelle eine App oder wähle eine bestehende
4. Kopiere Client ID und Client Secret

Sandbox vs. Live

• Sandbox-Modus: Zum Testen ohne echte Transaktionen
• Live-Modus: Für echte Zahlungen

Wähle den korrekten Modus in der PayPal-Konsole!

---

Wizard abschließen

Nach Eingabe der API-Schlüssel:

1. Tippe auf „Einrichtung abschließen”
2. Die Konfiguration wird gespeichert
3. Du siehst die Erfolgsmeldung: „Zahlungen erfolgreich eingerichtet!”
4. Das Setup wird als „Konfiguriert” markiert

---

Skip-Option

Du kannst diesen Schritt überspringen:

1. Tippe auf „Später einrichten” oder „Überspringen”
2. Das Setup wird als „Übersprungen” markiert
3. Du kannst die Konfiguration jederzeit im Zahlungs-Editor nachholen

Ohne Anbieter keine Zahlungen

Ohne konfigurierte Zahlungsanbieter können keine Online-Zahlungen verarbeitet werden. Das Modul funktioniert dann nicht vollständig.

---

Fehlerbehebung

Service Account fehlt

„Bitte richten Sie zuerst einen Service Account ein”

Problem	Lösung
Kein Service Account	Service Account einrichten
Service Account nicht validiert	Service Account validieren

Alternative: Überspringe den Schritt und konfiguriere später im Editor.

Setup fehlgeschlagen

„Die Einrichtung konnte nicht abgeschlossen werden”

Problem	Lösung
Netzwerkfehler	Internetverbindung prüfen
Service Account-Berechtigungen	Berechtigungen prüfen
Firebase-Projekt nicht korrekt	Firebase-Konfiguration prüfen

Prüfe:

1. Internetverbindung aktiv?
2. Service Account hat Berechtigungen?
3. Firebase-Projekt ist korrekt konfiguriert?

API-Schlüssel ungültig

Verbindungstest fehlgeschlagen

Problem	Lösung
Falscher Schlüssel kopiert	Schlüssel erneut aus Dashboard kopieren
Test- statt Live-Schlüssel	Korrekten Schlüsseltyp verwenden
Konto nicht aktiviert	Stripe/PayPal-Konto aktivieren

Stripe-Checkliste:

• Publishable Key beginnt mit pk_?
• Secret Key beginnt mit sk_?
• Kein Leerzeichen am Anfang/Ende?

PayPal-Checkliste:

• Client ID und Secret passen zusammen?
• App ist im richtigen Modus (Sandbox/Live)?

---

Tipps

Testmodus zuerst

Beginne immer mit Test-/Sandbox-Schlüsseln. Wechsle erst zu Live-Schlüsseln, wenn alles funktioniert.

Beide Anbieter aktivieren

Die Kombination aus Stripe und PayPal erreicht die meisten Kunden. Manche bevorzugen PayPal, andere Kreditkarten.

Webhook konfigurieren

Der Stripe-Webhook ermöglicht Echtzeit-Updates bei Zahlungsstatus-Änderungen. Konfiguriere ihn im Zahlungs-Editor.

Secret Keys schützen

Teile niemals deine Secret Keys. Sie werden verschlüsselt in Firebase gespeichert und sind in der App nicht sichtbar.

---

Nächste Schritte

Währung konfigurieren Währungseinstellungen anpassen

Zahlungs-Editor Alle Einstellungen im Detail

Zurück zur Übersicht Zahlungen-Modul Setup Übersicht