Zum Hauptinhalt springen
Beim PayPal Express Checkout beginnt der Käufer den Bezahlvorgang schon im Warenkorb. Er meldet sich bei PayPal an, und PayPal schickt ihn mit seinen Daten zurück in den Shop: Name, E-Mail-Adresse, Lieferadresse und die Beträge, über die der Vorgang läuft. Diese Antwort legt das Shopsystem ab, und die PAYPALEXPRESS-Tags holen einzelne Felder daraus. Wegweiser: PayPal Express Checkout

​
Wann die Tags arbeiten

Die Tags sind an den Express-Checkout gebunden. Sie liefern in genau zwei Fällen etwas: solange der Käufer sich im Express-Checkout befindet, und nach einer abgeschlossenen Bestellung, die über den Express-Checkout gelaufen ist. In jedem anderen Fall gelten sie als ungültiges Tag, unabhängig vom Template. Genau diese Bedingung prüft auch ST-PayPalExpressCheckout_selected. Klammern Sie Ihren Block damit, dann steht er auf der Seite immer dann, wenn die Tags darin auch Werte haben.
Referenz: ST- (Seitenzustände)
Die Tags gelten ausschließlich für den klassischen PayPal Express Checkout. Die neueren Express-Varianten über PayPal Checkout, Google Pay und Apple Pay laufen über eigene Zustände, und die Daten daraus erreichen Sie nicht über diese Tags.

​
Das Bauprinzip

Es gibt keine feste Tag-Liste. Das Shopsystem legt die Antwort von PayPal als Liste von Feldnamen und Werten ab und sucht beim Auflösen eines Tags schlicht nach dem Namen hinter PAYPALEXPRESS-. Jedes Feld, das PayPal zurückliefert, ist damit erreichbar, auch wenn es unten nicht aufgeführt ist.
Ein Feldname, den die Antwort nicht enthält, ist kein Fehler. Der Einzel-Tag gibt dann nichts aus und die Klammerung greift nicht. PayPal liefert viele Felder nur unter bestimmten Umständen, deshalb lohnt sich die Klammerung bei fast jedem Feld. Die Groß- und Kleinschreibung des Feldnamens spielt keine Rolle. Die Schreibweise in Großbuchstaben auf dieser Seite folgt der Schreibweise von PayPal und macht im Template auf einen Blick sichtbar, dass der Wert von außen kommt. Die Werte werden HTML-kodiert ausgegeben und sind bereits in den Zeichensatz des Shops umgewandelt. Zeilenumbrüche innerhalb eines Wertes ersetzt das Shopsystem durch Leerzeichen, sodass kein Feld das Layout sprengt.

​
Käufer und Transaktion

PAYPALEXPRESS-CORRELATIONID ist die Kennung, nach der der PayPal-Support fragt, wenn ein Vorgang geklärt werden muss. Sie gehört deshalb in die Protokollierung oder in einen Kommentar im Quelltext der Bestätigungsseite, nicht sichtbar auf die Seite.

​
Statuswerte

PAYPALEXPRESS-PAYERSTATUS sagt, ob PayPal das Konto des Käufers geprüft hat. PAYPALEXPRESS-BILLINGAGREEMENTACCEPTEDSTATUS betrifft wiederkehrende Zahlungen. PAYPALEXPRESS-CHECKOUTSTATUS sagt, wie weit die Zahlung gediehen ist.

​
Die Beträge der Bestellung

Die Beträge liegen unter dem Namensbestandteil PAYMENTREQUEST_0_. Die Null darin ist die laufende Nummer der Zahlungsanforderung, und im Shopsystem gibt es davon immer genau eine.
Nur Währungscode und Gesamtsumme sind verlässlich gefüllt. Alle übrigen Beträge liefert PayPal nur, wenn der Shop sie bei der Anfrage mitgeschickt hat. Klammern Sie jede einzelne Zeile, sonst stehen auf der Seite Beschriftungen ohne Wert.Diese Beträge sind die Werte, über die PayPal den Vorgang führt. Sie sind nicht die Summen des Warenkorbs. Für die Anzeige gegenüber dem Käufer nehmen Sie die Warenkorb- und Bestelltags des Shops. Die Werte hier eignen sich zum Abgleich, wenn Betrag und Bestellung auseinanderzulaufen scheinen.

​
Die Lieferadresse von PayPal

Beim Express Checkout kommt die Lieferadresse von PayPal. Sie liegt ebenfalls unter PAYMENTREQUEST_0_.
SHIPTOSTATE ist in Deutschland meist leer und in den Vereinigten Staaten immer gefüllt. Klammern Sie die Zeile, sonst steht in deutschen Adressen eine leere Zeile mitten im Block.

​
Der Prüfstatus der Adresse

PAYPALEXPRESS-PAYMENTREQUEST_0_ADDRESSSTATUS sagt, ob PayPal die Adresse geprüft hat. PAYPALEXPRESS-PAYMENTREQUEST_0_ADDRESSNORMALIZATIONSTATUS betrifft ausschließlich Adressen in Brasilien.

​
Die Tags im Überblick

Die Tags sind auf allen Templates zulässig, liefern aber nur im Express-Checkout und nach einer darüber abgeschlossenen Bestellung einen Wert.

​
Verwandte Themen