Übertragung der Zahlungsdaten
Einführung
Technische Übersicht
Handbuch
Codebeispiele

Technische Übersicht


Die Übertragung der Zahlungsdaten bietet Händlern die Möglichkeit, Transaktionsdetails für Käufer anzuzeigen, die nach Abschluss der Zahlung wieder zu ihrer Site zurückgeleitet werden.

So geht's

Sobald Sie die Übertragung der Zahlungsdaten aktiviert haben, wird immer ein Transaktionstoken als "GET"-Variable an diesen Rückleitungs-URL mitgesendet. Dies geschieht, wenn ein Käufer eine Websitezahlung tätigt und an Ihre Rückleitungs-URL zurückgeleitet wird. Um die Übertragung der Zahlungsdaten korrekt nutzen und Ihrem Kunden die Transaktionsdetails anzeigen zu können, sollten Sie das Transaktionstoken, den Variablennamen "tx" und die Transaktionsdetails durch Erstellung eines HTTP-POSTS für PayPal abrufen.

Ihr POST sollte an folgende URL gesendet werden: https://www.paypal.com/cgi-bin/webscr. Sie müssen das Transaktionstoken unter Verwendung der Variable "tx" und des Werts des zuvor empfangenen Transaktionstokens (z.B. "tx=transaction_token") senden, und das spezielle Identitätstoken unter Verwendung der Variable at und des Werts Ihres Identitätstokens für die Übertragung von Zahlungsdaten (z.B. "at=identity_token") senden Sie müssen außerdem eine Variable namens "cmd" mit dem Wert "_notify-synch" (z.B. "cmd=_notify-synch") an die POST-Zeichenfolge anhängen.

Das PayPal-System antwortet mit einem Wort, SUCCESS oder FAIL, in einer Zeile im Textfeld der Antwort auf dieses Posting. Wenn Sie die Antwort SUCCESS erhalten, besteht der restliche Antworttext aus den Transaktionsdetails. Es wird jeweils ein Detail pro Zeile im Format Schlüssel=Wert angezeigt, wobei sowohl der Schlüssel als auch der Wert als URL-codierte Zeichenketten erscheinen. Die Syntax dieser Antwortdaten muss entsprechend analysiert, und anschließend müssen die Antwortdaten Web-decodiert werden.

Beispiel für eine erfolgreiche Antwort:
SUCCESS
first_name=Jane+Doe
last_name=Smith
payment_status=Completed
payer_email=janiedoesmith%40hotmail.com
payment_gross=3,99
mc_currency=USD
custom=For+the+purchase+of+the+rare+book+Green+Eggs+%26+Ham
...

Sie können Ihrem Kunden alle Zahlungsdetails anzeigen, die Sie für sinnvoll erachten. PayPal empfiehlt jedoch, in jedem Fall die Lieferadresse, die E-Mail-Adresse des Zahlenden sowie den gezahlten Betrag anzuzeigen. Wenn Sie die Übertragung von Zahlungsdaten verwenden, um festzulegen, wann ein Auftrag automatisch ausgeführt werden soll, müssen Sie sicherstellen, dass der "payment_status" "Abgeschlossen" lautet, da der Käufer Zahlungsmethoden verwenden könnte, bei denen keine sofortige Verrechnung erfolgt.

Wenn Sie diese Daten zur Abwicklung von Aufträgen verwenden, empfiehlt PayPal dringend, die sofortige Zahlungsbestätigung zu aktivieren, um festzustellen, wann die offenen Zahlungen gebucht werden. Weitere Informationen dazu finden Sie im Handbuch zu sofortigen Zahlungsbestätigungen von PayPal, das auf der PayPal-Website zur Verfügung steht.

Wenn Sie die Antwort FAIL erhalten, können Sie versuchen, eine Rücksendung an PayPal durchzuführen um festzustellen, ob der Fehler auf einen Netzwerkfehler zurückzuführen ist. Schlägt der zweite Versuch jedoch ebenfalls fehl, sollten Sie Ihr Skript überprüfen und weitere Untersuchungen durchführen:
  • Stellen Sie sicher, dass txn_id kein Duplikat ist, um zu verhindern, dass jemand von einer alten, abgeschlossenen Transaktion erneut Gebrauch macht.
  • Bestätigen Sie, dass als receiver_email die in Ihrem PayPal-Konto registrierte E-Mail-Adresse angegeben ist, damit Zahlungen nicht an ein Betrüger-Konto gesendet werden
  • Kontrollieren Sie weitere Transaktionsdetails wie die Artikelnummer und den Preis, um sicherzustellen, dass der Preis nicht geändert wurde.

Variablen für sofortige Zahlungsbestätigung

Eine vollständige Liste aller IPN-Variablen und detaillierte Anweisungen zur Verwendung von sofortigen Zahlungsbestätigungen lesen Sie das Integrationsleitfaden für Websitezahlungslösungen

Adobe Acrobat ist erforderlich, um die PayPal-Handbücher zu lesen.