PHPGangsta - Der praktische PHP Blog

Über PayPal gibt es unterschiedlichste Meinungen, die Sperrungen von Accounts sind teilweise willkürlich, in wie weit die amerikanische Regierung die Finger im Spiel hat mag man sich auch ausmalen. Nichtsdestotrotz ist es der aktuell am meisten verbreitete Online-Zahlungsdienst und man kann nahezu überall damit bezahlen. Kein Shop kann sich erlauben keine PayPal Zahlungen anzunehmen, einige Studien sprechen von 18% mehr Umsatz bei Einkäufen wenn PayPal angeboten wird.

Wenn man selbst PayPal Zahlungen entgegen nehmen möchte und diese automatisiert abarbeiten möchte benötigt man die Funktion Instant Payment Notification von PayPal. Im deutschen PayPal wird es „Sofortige Zahlungsbestätigung“ genannt. Ich nehme immer die Abkürzung IPN.

IPN ist ein einfaches Feature: Wann immer eine Transaktion auf dem eigenen Konto stattfindet wird eine bestimmte URL aufgerufen die wir spezifizieren können. Eine Transaktion ist beispielsweise ein Abonnement, Rückzahlung, Rückbuchung, offene oder abgelehnte Zahlung.

Um das IPN-Feature zu aktivieren geht man im PayPal Interface auf „Mein Profil -> Mehr -> Einstellungen für sofortige Zahlungsbestätigung“ und trägt dort eine URL ein, beispielsweise http://www.meinshop.de/payment/paypalipn.php

Dort legen wir dann ein Script hin, und PayPal schickt uns dorthin via POST die Details zum Zahlungsvorgang. Diese können wir dann verifizieren, eigene Prüfungen auf Korrektheit, Sinnhaftigkeit und Vollständigkeit machen, und dann die Zahlung im Shop als bezahlt markieren.

Für die Verifizierung bietet PayPal einen kleinen Dienst an, dorthin kann man die Daten einer Transaktion schicken und sich bestätigen lassen dass sie alle korrekt sind und es diese Zahlung wirklich gegeben hat. Sonst könnte jemand, der die URL herausfindet, gefälschte Daten an unser paypalipn.php Script schicken. Dann ist also sichergestellt dass es die Transaktion bei PayPal gegeben hat, wir prüfen als nächstes ob die Empfänger-E-Mail-Adresse eine unserer E-Mail-Adressen ist, denn ein findiger Mensch könnte ja einfach die Transaktionsdaten an unser Script schicken wie er sich selbst Geld geschickt hat. Als letztes prüfen wir noch den Betrag sowie die eventuell vorhandene Anzahl von gekauften Waren etc.

Wenn das alles geprüft wurde können wir sicher sein dass es eine reguläre Zahlung war und die Bestellung im Shop als bezahlt markieren, eine nette E-Mail an den Kunden schicken dass wir das Geld erhalten haben und die Ware verschicken, bzw. den gekauften Artikel zum Download anbieten, oder was auch immer man machen muss wenn der Kunde bezahlt hat.

Um diese Validierung gegen die PayPal Server und die weiteren Prüfungen etwas zu vereinfachen habe ich eine Klasse geschrieben die die Arbeit auf das notwendigste beschränkt. Ihr findet sie auf GitHub unter dem Namen „PayPal IPN“.

Dort sind Beispieldateien hinterlegt wie die Klasse zu benutzen ist. Meine Basisklasse PHPGangsta_PayPalIPN sollte dazu erweitert werden und mit den nötigen Dingen versehen werden, wie beispielsweise dem E-Mail-Check und den Dingen die bei erfolgter Zahlung passieren sollen (Datenbankeintrag, E-Mail…).

So sieht dann die Benutzung aus. Hier ein Beispiel des Hauptscripts, das nur die Klasse benutzt und die $_POST Daten übergibt:

https://github.com/PHPGangsta/PayPal-IPN/blob/master/example/paypalipn.php

Die eigentliche „Arbeit“ macht dann die folgende Klasse, darin sind die benötigten Methoden überschrieben und mit Leben gefüllt:

https://github.com/PHPGangsta/PayPal-IPN/blob/master/App/PayPalIPN.php

Das ist das einfache Beispiel, in einem vollständigen Script würde man wahrscheinlich auch noch _checkTxnId(), _checkAmount() und die weiteren _status*() Methoden überschreiben. Aber für einen ersten Test reicht dieses Beispiel.

Bei Fragen und Verbesserungen würde ich mich freuen wenn ihr Kommentare hinterlasst, mich würde interessieren wie ihr das bisher gemacht habt falls ihr schonmal mit PayPal IPNs zu tun hattet. Welche Features fehlen noch?