Docs

Zahlungen

PayPal verbinden

Käufer zahlen auf dein eigenes PayPal-Konto. Bei Preisen unter 10 $ ist PayPal günstiger als Stripe, sobald es dir seinen Micropayments-Tarif gibt; beim Standardtarif ist Stripe günstiger.

Dein Konto verbinden

PayPal wird über deine eigene PayPal-REST-App verbunden: eine in der PayPal-Sandbox für Test und eine für Live.

  1. Erstelle eine REST-App. Erstelle im Developer Dashboard von PayPal unter Apps & Credentials eine App in der Sandbox. Eine Live-App erstellst du beim Livegang.
  2. Verbinde sie. Wähle unter Zahlungen bei PayPal im Testbereich Verbinden und verbinde deine Sandbox-App. Wir speichern ihr Secret verschlüsselt.
  3. Füge unseren Webhook hinzu. Füge auf der Webhooks-Seite der App in PayPal die Adresse hinzu, die Zahlungen dir zeigt, genau wie angezeigt.
  4. Hake vier Events an. PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.REFUNDED, CUSTOMER.DISPUTE.CREATED und CUSTOMER.DISPUTE.RESOLVED.
  5. Sende ein Test-Event. Nutze Simulate events auf dieser Seite. Binnen einer Minute erscheint es unter Zahlungen.
  6. Verbinde live beim Livegang. Wiederhole diese Schritte mit deiner Live-App im Live-Bereich.
  • Eine Verbindung gilt für alle deine Apps. Test und Live werden getrennt verbunden.
  • Beim Verbinden oder Trennen bestätigst du erneut, dass du es bist, wenn deine Anmeldung mehr als 10 Minuten her ist.
  • Liegen die meisten deiner Preise unter 10 $, frag PayPal nach seinen Micropayment-Gebühren.

Wie der Käufer zahlt

Der QR-Code der Uhr öffnet die Seite von PayPal auf dem Handy, schon mit dieser Uhr verknüpft. Der Käufer genehmigt die Zahlung dort mit seinem PayPal-Guthaben oder einer Karte, und wir schließen sie dann auf deinem Konto ab. Das Geld landet in deinem PayPal-Guthaben; abheben kannst du es bei PayPal.

Worauf wir hören

PayPal-EventWas es bedeutetWas die Uhr tut
PAYMENT.CAPTURE.COMPLETEDBezahltSchaltet binnen etwa einer Sekunde frei, wenn ihr Kaufbildschirm offen ist; sonst bei ihrer nächsten Anfrage.
PAYMENT.CAPTURE.REFUNDEDErstattetSperrt bei ihrer nächsten Prüfung; sofort, wenn ihr Kaufbildschirm offen ist.
CUSTOMER.DISPUTE.CREATEDEine Anfechtung wurde eröffnetGesperrt, solange die Anfechtung offen ist.
CUSTOMER.DISPUTE.RESOLVEDDie Anfechtung ist beendetGewonnen: schaltet wieder frei, außer bei Erstattung. Verloren: bleibt gesperrt.

Wir prüfen jedes Event gegen die Bezahlseite, die wir erstellt haben: Uhr und App, Betrag, Währung sowie Sandbox oder Live.

Wenn PayPal uns nicht erreicht

Schlagen die Versuche von PayPal fehl, uns zu erreichen, zeigt Zahlungen Braucht Aufmerksamkeit und Lösung ansehen. Zahlungen gehen in der Zeit weiter durch, aber Erstattungen sperren keine Uhren, bis es wieder funktioniert. Die Lösung:

  1. Öffne die Webhooks deiner App. PayPal Developer Dashboard, Apps & Credentials, deine App, Webhooks.
  2. Prüfe die Adresse. Sie muss genau mit der unter Zahlungen übereinstimmen.
  3. Prüfe die Events. Alle vier aus der Tabelle oben.
  4. Sende ein Test-Event. Simulate events. Binnen einer Minute erscheint es und die Warnung verschwindet.

Erstattungen und Rückbuchungen

  • Erstatte in PayPal. Ein Verkauf unter Verkäufe verlinkt direkt dorthin.
  • Reagiere auf Anfechtungen in PayPal. Die Uhr bleibt gesperrt, solange eine Anfechtung offen ist.
  • Teste nur in der Sandbox: Zahle mit einem Sandbox-Käuferkonto und erstatte aus der Sandbox. Teste Erstattungen oder Anfechtungen nie auf deinem Live-Konto.

Was die Uhr in jedem Fall tut, steht unter Erstattungen, Anfechtungen und Verlängerungen.

Esc