PayPal
PayPal verbinden, um in den Checkout-Abläufen, die du mit condoo.Vibe erstellst, Zahlungen per PayPal, Pay Later und Karte sowie PayPal-Abonnements anzunehmen.
Mit dem PayPal-Connector können Anwendungen, die du mit condoo.Vibe erstellst, Zahlungen über PayPal annehmen.
Du kannst PayPal für Folgendes verwenden:
- Eine PayPal-Schaltfläche im Checkout
- Einmalzahlungen für Bestellungen, Buchungen und Tickets
- Pay Later, sofern der Käufer dafür infrage kommt
- Kartenzahlungen über die PayPal-Schaltfläche
- Monatliche Abonnements
- Alles mit Sandbox-Konten testen, bevor echtes Geld fließt
PayPal verbinden. Beschreiben, wofür Kunden bezahlen. condoo.Vibe erstellt den Checkout.
PayPal und Stripe
Beide Connectors nehmen Zahlungen an. Viele Produkte nutzen einen davon, manche bieten beide an.
| Du möchtest | Verwende |
|---|---|
| Kunden mit ihrem PayPal-Guthaben oder mit Pay Later bezahlen lassen | PayPal |
| Einen Karten-Checkout, der bei deinem Zahlungsanbieter gehostet wird | Stripe |
| Kunden im Checkout die Wahl lassen | Beide |
Wenn du Zahlungen anforderst, ohne einen Anbieter zu nennen, verwendet condoo.Vibe die Zahlungs-Connectors, die du verbunden hast. Um sicherzugehen, nenne PayPal in deiner Anfrage ausdrücklich.
Vor dem Start
Du benötigst:
- Ein PayPal-Konto, um dich im PayPal-Entwickler-Dashboard anzumelden
- Ein PayPal-Geschäftskonto, sobald du echte Zahlungen annehmen möchtest
Du kannst zunächst alles mit Sandbox-Zugangsdaten entwickeln und testen.
PayPal mit condoo.Vibe verbinden
Das PayPal-Entwickler-Dashboard öffnen
Melde dich auf developer.paypal.com mit deinem PayPal-Konto an.
Sandbox auswählen
Öffne Apps & Credentials und stell sicher, dass der Schalter auf Sandbox steht.
Eine App öffnen
Öffne die Default Application oder klicke auf "Create App" und benenne die App nach deinem Projekt.
Deine Zugangsdaten kopieren
Kopiere die Client ID und das Secret.
In deinem Projekt verbinden
Öffne dein condoo.Vibe-Projekt, wechsle zu Connectors und wähle PayPal aus. Füge die Client ID und das Secret ein und setze Mode auf sandbox.
Außerdem kannst du im Feld Currency eine Währung festlegen. Verwende die Hauptwährung deines PayPal-Kontos: Eine Zahlung in einer anderen Währung kann in deinem PayPal-Konto warten, bis du sie von Hand annimmst. Lässt du das Feld leer, werden Preise in US-Dollar (USD) angegeben.
Nach dem Verbinden prüft die Connector-Seite deine Zugangsdaten bei PayPal. Gehören sie zum anderen Modus, zeigt sie dir an, welchen Wert du bei Mode wählen musst.
Mit Sandbox-Konten testen
Im Sandbox-Modus fließt kein echtes Geld.
Um in deiner Vorschau zu bezahlen, melde dich im PayPal-Fenster mit einem Sandbox-Käuferkonto an, nicht mit deinem echten PayPal-Login. Du findest eines im PayPal-Entwickler-Dashboard unter Testing Tools und dann Sandbox Accounts.
Solange deine App im Sandbox-Modus läuft, weist ihr Checkout darauf hin und sagt dir, welchen Login du verwenden sollst.
Dein erster PayPal-Checkout
Angenommen, du verkaufst Tickets für eine Veranstaltung.
Teile condoo.Vibe mit:
Besucher sollen Tickets für meine Veranstaltung mit PayPal kaufen können. Ticketart und Preis anzeigen, eine PayPal-Schaltfläche hinzufügen und dem Käufer nach der Zahlung sein Ticket per E-Mail senden.
Der Ablauf könnte so aussehen:
Besucher wählt Ticket
↓
Bestellung erstellt
↓
PayPal-Schaltfläche
↓
Käufer genehmigt
↓
Zahlung auf dem Server erfasst
↓
Bestellung als bezahlt markiert
Die PayPal-Schaltfläche zeigt PayPal, Pay Later und Kartenzahlung an, je nachdem, wofür der Käufer infrage kommt.
Wie die Zahlung bestätigt wird
Eine Bestellung wird erst als bezahlt markiert, wenn der Server deiner App die Zahlung bei PayPal erfasst hat und PayPal sie als abgeschlossen meldet.
Das Erreichen einer Erfolgsseite im Browser ist kein Zahlungsnachweis, deshalb verlässt sich deine App nie darauf.
Deine App benötigt dafür keine Webhooks. Die Erfassung antwortet sofort, sodass die Bestätigung in derselben Anfrage erfolgt.
Schließt der Käufer die Seite mittendrin, kann deine App dieselbe Bestellung fortsetzen, statt eine neue zu erstellen. So bezahlt niemand doppelt.
Abonnements
PayPal kann auch ein monatliches Abonnement abrechnen.
Zum Beispiel:
Für den Pro-Tarif ein monatliches PayPal-Abonnement über $29 abrechnen. Nur aktive Abonnenten können die Berichtsseite öffnen.
Vereinfacht dargestellt:
Tarif auswählen
↓
PayPal-Abonnement
↓
Käufer genehmigt
↓
Status geprüft
↓
Zugang gewährt
Deine App prüft das Abonnement bei PayPal, bevor sie Zugang gewährt, und danach regelmäßig erneut:
- Nur ein aktives Abonnement schaltet kostenpflichtige Funktionen frei.
- Ein in PayPal gekündigtes oder ausgesetztes Abonnement verliert den Zugang, auch wenn der Kunde nie zu deiner App zurückkehrt.
- Ist PayPal nicht erreichbar, wird der Kunde gebeten, es erneut zu versuchen, statt Zugang zu erhalten.
Live gehen
Wenn du für echte Kunden bereit bist:
- Stelle den Schalter im PayPal-Entwickler-Dashboard auf Live. Dafür ist ein PayPal-Geschäftskonto erforderlich.
- Kopiere die Client ID und das Secret für Live.
- Füge sie auf der PayPal-Connector-Seite ein und setze Mode auf live.
- Führe eine kleine echte Zahlung durch, um den gesamten Ablauf zu bestätigen.
Rückerstattungen und Konflikte bearbeitest du in deinem PayPal-Konto.
Häufige Probleme
PayPal meldet, dass die Zugangsdaten zum anderen Modus gehören
Sandbox- und Live-Zugangsdaten unterscheiden sich. Stelle Mode passend zu der Umgebung ein, aus der du sie kopiert hast, oder füge die Zugangsdaten für den gewünschten Modus ein.
PayPal lehnt Client ID und Secret ab
Prüfe, ob beide vollständig aus derselben App im PayPal-Entwickler-Dashboard kopiert wurden und ob die App nicht gelöscht wurde.
Du kannst dich in deiner Vorschau nicht im PayPal-Fenster anmelden
Verwende im Sandbox-Modus ein Sandbox-Käuferkonto aus Testing Tools und dann Sandbox Accounts. Dein echter PayPal-Login funktioniert nur im Live-Modus.
Eine Zahlung wartet in PayPal
Die Zahlung erfolgte in einer Währung, die dein PayPal-Konto nicht führt. Nimm sie in deinem PayPal-Konto an und stelle im Feld Currency auf der Connector-Seite die Hauptwährung deines Kontos ein.
Ein Abonnent hat den Zugang verloren
Prüfe den Status des Abonnements in deinem PayPal-Konto. Nur ein aktives Abonnement schaltet kostenpflichtige Funktionen frei.
PayPal-Fehler untersuchen
Eine gute Anfrage im Debug-Modus könnte so aussehen:
Erwartet: Nachdem ein Käufer die PayPal-Zahlung genehmigt hat, soll die Bestellung als bezahlt markiert und das Ticket per E-Mail gesendet werden.
Tatsächlich: Der Käufer genehmigt die Zahlung, aber die Bestellung bleibt ausstehend.
PayPal wird im Sandbox-Modus als verbunden angezeigt.
Fehler: [FEHLER EINFÜGEN, FALLS VORHANDEN]
Die PayPal-Erfassung untersuchen, ohne die Ticketauswahl zu ändern.
Füge dein PayPal-Secret niemals in einen Prompt ein.
Den PayPal-Ablauf testen
Teste vor der Veröffentlichung:
- Eine erfolgreiche Zahlung mit einem Sandbox-Käuferkonto
- Eine abgebrochene Zahlung
- Das Neuladen der Seite während des Checkouts
- Den Bestellstatus nach der Zahlung
- Bestätigungs-E-Mails
- Abschließen und Kündigen eines Abonnements sowie den Verlust des Zugangs
- Die richtige Währung und die richtigen Beträge
- Den Checkout auf Mobilgeräten
Ein guter PayPal-Prompt
Eine gute Anfrage legt fest:
- Produkt: Wofür bezahlt der Kunde?
- Preis: Wie viel und in welcher Währung?
- Art: Einmalzahlung oder Abonnement?
- Nach der Zahlung: Was soll passieren, sobald sie bestätigt ist?
- Zugang: Was schaltet ein zahlender Kunde frei?
Zum Beispiel:
Der Buchungsseite einen PayPal-Checkout hinzufügen. Den Preis der ausgewählten Sitzung in GBP abrechnen, die Buchung erst nach Erfassung der Zahlung als bezahlt markieren und dem Kunden eine Bestätigung per E-Mail senden. Wenn die Zahlung abgebrochen wird, die Buchung als unbezahlt belassen und dem Kunden einen erneuten Versuch ermöglichen.
Das ist deutlich aussagekräftiger als:
PayPal hinzufügen.
Als Nächstes: Resend
PayPal kümmert sich um Zahlungen.
Als Nächstes verbinden wir deine Anwendung mit Resend, damit sie über Transaktions-E-Mails mit Nutzern kommunizieren kann.