Zum Hauptinhalt springen
PayPal lässt sich auf zwei Ebenen in den Shop bringen. Als Zahlungsart steht es bei den anderen zur Auswahl, der Käufer durchläuft den gewohnten Bestellablauf und zahlt am Ende bei PayPal. Als Express Checkout steht es schon am Warenkorb: Ein Klick, und der Käufer springt an Anmeldung und Adresseingabe vorbei, weil PayPal seine Adresse mitliefert. Darunter liegt eine zweite Entscheidung, nämlich wie der Shop technisch mit PayPal spricht.

Die beiden Anbindungsarten

Die Entscheidung fällt vor der Einrichtung, nicht danach. Express Checkout gibt es nur mit der Direktanbindung. Wer über Computop anbindet und später Express Checkout möchte, muss die Anbindung wechseln, und das begleitet die WEBSALE-Technik.
Neben der hier beschriebenen Anbindung gibt es in WEBSALE V8s auch PayPal Checkout als eigene, neuere Zahlungsart mit eigenem Konfigurationsabschnitt. Klären Sie mit Ihrem WEBSALE-Ansprechpartner, welche Variante für Ihren Shop vorgesehen ist, bevor Sie anfangen. Wegweiser: PayPal-Checkout · Computop
giropay lässt sich bei PayPal nicht mehr als Zahlungsmittel wählen. Als eigenständige Zahlungsart im Shop steht es weiterhin zur Verfügung.
Wegweiser: giropay Online-Überweisung

PayPal als Zahlungsart

Paypal Zahlungsart

Wie der Bezahlvorgang abläuft

Paypalstandardflow
  1. Der Käufer gibt seine Adressdaten wie gewohnt ein.
  2. Auf der Zahlungs- und Versandartenseite wählt er PayPal und seine Versandart.
  3. Auf der Bestellübersicht bestätigt er. Dabei öffnet sich PayPal.
  4. Er meldet sich bei PayPal an, bestätigt und kommt zurück in den Shop.
  5. Der Shop zeigt die Bestelleingangsbestätigung ws_confirm.htm.

Schritt 1: Konto und Freischaltung

Sie brauchen ein PayPal-Geschäftskonto. Bei der Anbindung über Computop kommt ein Händlervertrag mit Computop dazu. Anschließend schaltet WEBSALE die gewählte Anbindung frei.

Schritt 2: Zahlungsart anlegen

LanguageCode ist optional und bestimmt die Sprache der PayPal-Seite. Zulässig sind der zweistellige Sprachcode oder der fünfstellige Locale-Code. Referenz: Abschnitt PaymentPaypal-Txt · Abschnitt PaymentXXX-Txt

Schritt 3: Hinweismeldungen hinterlegen

Bei Online-Zahlungsarten lohnt sich zusätzlich ein Sicherheitshinweis im Shop, der erklärt, was beim Wechsel zur Zahlungsseite passiert. Referenz: Abschnitt NotifyMessages-Txt · Wegweiser: Sicherheitshinweis bei Online-Zahlungsarten

Schritt 4: Testen

Mit TestMode = yes ist die Zahlungsart nur im Zahlungsarten-Testmodus sichtbar. Dabei müssen Sie wissen, gegen welches PayPal-Konto Sie testen.
Zum Beenden setzen Sie die jeweiligen Parameter auf off und danach TestMode auf no. Der PayPal-Testmodus lässt sich im Template sichtbar machen:
Der Sandbox-Betrieb muss von WEBSALE eingerichtet werden, dafür brauchen wir Ihre PayPal-Sandbox-Zugangsdaten. Er ist auch der richtige Weg, wenn Sie die Anbindungsart wechseln oder auf andere Zugangsdaten umstellen wollen. Wegweiser: Testmodi des Shops ein- und ausschalten

PayPal Express Checkout

Paypalexpresscheckout Flow Der Express Checkout setzt einen Knopf neben den Warenkorb. Wer darauf klickt, landet direkt bei PayPal, meldet sich an und kommt mit Adresse und Zahlungsmittel zurück auf die Bestellübersicht. Die Zahlungs- und Versandartenseite überspringt er dabei. Das verkürzt den Weg erheblich, bringt aber Einschränkungen mit sich, die Sie vorher kennen sollten.
Diese Funktionen sind mit dem Express Checkout nicht möglich:
  • Mehrwertsteuererlass für Firmenkunden nach Abfrage der Umsatzsteuer-Identifikationsnummer
  • Reseller-Bestellungen
  • Frachtkostenkalkulator
  • Auswahl des Adress- oder Kundentyps über UserTypes bei abweichender Rechnungsadresse
Brauchen Sie eine davon, bleibt es bei PayPal als gewöhnlicher Zahlungsart.Im Express Checkout kann der Käufer auf der Bestellübersicht weder den Warenkorb noch die Lieferadresse noch die Zahlungsart ändern. PayPal erfährt von solchen Änderungen nichts mehr. Wer etwas ändern will, muss abbrechen und neu anfangen. Genau deshalb müssen Sie die entsprechenden Knöpfe dort ausblenden, siehe Schritt 5.
Was er ändern darf, ist die Versandart und die Rechnungsadresse. Beides müssen Sie auf der Bestellübersicht einbauen, denn die gewohnte Seite dafür entfällt.

Voraussetzungen

PayPal muss als Zahlungsart über die Direktanbindung eingerichtet sein. Zum Testen richtet WEBSALE zusätzlich eine Test-Direktanbindung mit Ihren Sandbox-Daten ein und entfernt sie danach wieder. Für die Testbestellungen brauchen Sie ein PayPal-Testkonto. An dessen E-Mail-Adresse gehen auch die Bestätigungsmails des Shops. Verwenden Sie deshalb eine Adresse, auf die derjenige Zugriff hat, der die Integration baut.

Schritt 1: Express Checkout einschalten

ExpressCheckoutMaxAmountAddition ist nötig, weil der Käufer seine Versandart erst nach der Freigabe bei PayPal wählt. PayPal muss deshalb vorher wissen, wie viel teurer die Bestellung dadurch höchstens wird. Setzen Sie den Wert so, dass die teuerste Versandart hineinpasst, sonst scheitert die Bestellung am Ende.

Schritt 2: Versandarten freigeben

Versandarten müssen für den Express Checkout ausdrücklich zugelassen werden.
Sobald Sie diesen Parameter irgendwo verwenden, brauchen auch die Versandarten des gewöhnlichen Bestellablaufs den Wert Standard. Vergessen Sie ihn, verschwinden sie aus dem normalen Ablauf.
Referenz: Abschnitt +Deliverer

Schritt 3: Knopf auf die Warenkorbseite

Die Klammerung {ST-PayPalExpressCheckout} blendet den Knopf aus, wenn der Express Checkout gerade nicht möglich ist. Das ist der Fall, wenn er nicht freigeschaltet ist, wenn der Warenkorb nicht bestellbereit ist, wenn die Gesamtsumme null oder kleiner ist oder wenn ein Filter PayPal für diese Bestellung ausschließt. Verschiedene Knopfgestaltungen stellt PayPal in seinem Logo-Center bereit.

Schritt 4: Fehlermeldungen auf der Warenkorbseite

Schritt 5: Bestellübersicht umbauen

Hier liegt die eigentliche Arbeit. Die Bestellübersicht bekommt zwei Gesichter: eines für den gewöhnlichen Ablauf, eines für den Express Checkout. Ändern-Knöpfe ausblenden
Die von PayPal gelieferten Daten anzeigen
Abweichende Rechnungsadresse zulassen Standardmäßig wird die Lieferadresse von PayPal auch als Rechnungsadresse verwendet. Nimmt der Käufer den Haken heraus, erscheinen die Felder für eine eigene Rechnungsadresse, per AJAX nachgeladen.
Tragen Sie im Aufruf die ID Ihres eigenen Formulars ein, hier beispielhaft place_order_form.
Versandart auswählen lassen
Das JavaScript, das die Versandartenauswahl auf ws_pay_deliv.htm bedient, brauchen Sie hier ebenfalls. Diese Seite wird im Express Checkout übersprungen, ihr Skript kommt also nicht zum Zuge. Ohne das Skript lässt sich die Versandart nicht wählen.
Knöpfe und Hinweise
Dazu gehören die Meldungsbereiche, die sonst auf anderen Seiten stehen, sowie die Fehlermeldungen zu Liefer- und Rechnungsland.

Schritt 6: AGB auf die Bestellübersicht

Steht Ihre AGB-Zustimmung nicht auf der Bestellübersicht, müssen Sie sie für den Express Checkout dort zusätzlich einbauen. Der Käufer kommt sonst an keiner Seite vorbei, auf der er zustimmen könnte.

Schritt 7: Die übrigen Bestätigungen anpassen

Was Sie auf der Bestellübersicht ein- und ausgeklammert haben, gilt genauso für ws_confirm.htm, mail_customer_order.htm und pdf_confirm.htm. Referenz: ST-PayPalExpressCheckout · ST-PayPalExpressCheckout_selected · PAYPALEXPRESS-Tags · WS-DeliveryFields

Wichtige Einstellungen

Zeitpunkt des Zahlungseinzugs

PaypalPaymentAction bestimmt, was beim Bestellabschluss tatsächlich passiert. Wer erst nach Versand abrechnet, nimmt authorization oder order. Wer sofort versendet, nimmt sale.

Schwebender Status

PayPal meldet am Ende nicht immer ein klares Ja oder Nein. Der dritte Fall heißt „Pending”: Ob das Geld kommt, steht noch nicht fest. Der Shop schließt die Bestellung in diesem Fall trotzdem ab und speichert den Status mit den Bestelldaten.
Eine Bestellung mit dem Status „Pending” dürfen Sie nicht behandeln wie eine bezahlte. Prüfen Sie vor der Bearbeitung, ob das Geld bei PayPal eingegangen ist, so wie bei Vorauskasse.
Seltener wird dieser Fall, wenn Sie Ihr PayPal-Händlerkonto entsprechend einstellen und im Shop nur sofort gutgeschriebene Zahlungsmittel zulassen:

Wie der Warenkorb an PayPal geht

Der Käufer sieht bei PayPal, wofür er zahlt. Wie ausführlich, bestimmt die Art der Übergabe. Der Parameter heißt PassBasketToPayPal-ModeBasisCheckout für den gewöhnlichen Ablauf und PassBasketToPayPal-ModeExpressCheckout für den Express Checkout.
Übergeben Sie die Positionen einzeln, brauchen Zuschläge und Rabatte eigene Sammelpositionen, denn PayPal kennt keine Korrekturbeträge. Ohne sie geht die Rechnung bei PayPal nicht auf.
Betroffen sind Shops mit Rabatten, Gutscheinen oder Aufschlägen, beispielsweise für Web-to-Print-Produkte.

Lieferung nach Nordamerika

Nach USA, Kanada und Mexiko erwartet PayPal zusätzlich den Bundesstaat, die Provinz beziehungsweise den Bundesdistrikt der Lieferadresse. Hat der Käufer keine Lieferadresse gewählt, gilt die Rechnungsadresse. Diese Angabe fragen Sie als Zusatzinformation der Zahlungsart ab, mit je einem <+CountryRule>-Abschnitt pro Land.
Die Kennung ws_clearing_paypal_state ist fest vorgegeben und für alle drei Länder dieselbe. Der Shop setzt bei dieser Kennung außerdem von sich aus die Lieferadresse als Bezugsadresse, unabhängig davon, was Sie bei UseAddressInput eintragen. Die vollständigen Listen der Bundesstaaten, Provinzen und Distrikte finden Sie in den Materialien. Vergessen Sie nicht die allgemeine Fehlermeldung für fehlende Zusatzangaben:
Referenz: Abschnitt +CountryRule · Materialien: PayPal, vollständige Länderlisten

Was mit Express Checkout nicht geht

Brauchen Sie eine dieser Funktionen, bieten Sie PayPal als gewöhnliche Zahlungsart an. Wegweiser: USt-IdNr. abfragen · Reseller-Bestellungen unterstützen

Anbindungsart wechseln

Der Wechsel zwischen Direktanbindung und Computop läuft über einen Parallelbetrieb: Die neue Anbindung wird im Testmodus aufgebaut, während die alte produktiv weiterläuft.
Die Umstellung begleitet die WEBSALE-Technik. Stimmen Sie den Ablauf vorher ab.
  1. Legen Sie einen zweiten Abschnitt <PaymentPaypal-Txt> für die neue Anbindung an, mit Allow = yes und TestMode = yes.
  2. Rufen Sie den Shop mit ?test=on&payment-test=on&paypalaccount-test=on auf und bauen Sie die neue Anbindung fertig. Der Produktivbetrieb bleibt unberührt.
  3. Beenden Sie den Testmodus mit paypalaccount-test=off.
  4. Setzen Sie im Abschnitt der alten Anbindung Allow = no.
  5. Melden Sie sich bei Ihrem WEBSALE-Ansprechpartner, damit die Umkonfiguration erfolgt.
  6. Löschen Sie den alten Abschnitt und setzen Sie im neuen TestMode = no.

Bestelldaten

Eine Bestellung über den Express Checkout ist in den Bestelldaten an drei Stellen erkennbar.
ExpressCheckoutAddressUsed = yes ist ein Hinweis an Ihre Warenwirtschaft, dass die Adressdaten aus einem Express Checkout stammen. Daraus können fehlende oder doppelte Adressangaben entstehen. Prüfen Sie, wie Ihr System damit umgeht.

Verwandte Themen