Damit Sie als Online-Anbieter PayPal-Transaktionen über das abwickeln können, benötigen Sie ein Geschäftskonto bei PayPal. Weiterhin müssen Sie die PayPal-Schnittstelle für die Nutzung über das freigeben und die nötigen Einstellungen für den Empfang von Zahlungen vornehmen.
Damit über das PayPal-Transaktionen abgewickelt werden können, muss die API-Genehmigung für erteilt werden. Dazu führen Sie die nachfolgend erklärten sechs Schritte aus.
Für die PayPal Sandbox können die API-Genehmigungen folgendermaßen erteilt werden.
Um eine PayPal-Zahlung im -Formular abzuwickeln, nutzen Sie folgende URL und Parameter:
paypal.aspx |
Mit dieser URL unterstützt das zwei verschiedene PayPal-Methoden: Einerseits können Sie PayPal ganz normal als zusätzliche Zahlungsmethode zum Abschluss einer Bestellung anbieten. Zum anderen können Sie PayPal Express Checkout nutzen, damit der Kunde vom Warenkorb direkt zu PayPal gelangt und dort seine Liefer- und Rechnungsadresse auswählt. Dem Kunden erspart das die erneute Eingabe von Adressdaten und als Händler genießen Sie den PayPal Verkäuferschutz.
Das unterstützt auch für PayPal Express Checkout das Auseinanderfallen von Autorisierung und Buchung. Sie können über das über Parameter steuern, ob der Betrag auf dem PayPal-Account des Kunden geblockt oder gleich gebucht werden soll.
Hinweis: Bitte beachten Sie, dass eine PayPal-Anbindung im Shop per i-Frame aufgrund von PayPal-Regularien nicht möglich ist. Express Checkout funktioniert mit einer Weiterleitung des Kunden direkt zu PayPal.
Hinweis: Damit Sie vom PayPal Verkäuferschutz profitieren, muss eine der folgenden Bedingungen erfüllt sein. Entweder der Kunde nutzt PayPal Express Checkout und wählt eine bei PayPal selbst hinterlegte Lieferadresse aus, die das an Ihren Shop übergibt. Oder Ihr Shop übergibt die bereits bekannte Lieferadresse an PayPal. Der Verkäuferschutz gilt nur, wenn die Ware an diese angegebene Adresse geliefert wurde. Zwischen der Autorisierung des Betrags im PayPal-Konto des Kunden und der Buchung dürfen nicht mehr als 3 Tage liegen, wenn Sie vom Verkäuferschutz profitieren möchten. Das unterstützt deshalb mehrere Alternativen zur Abwicklung von PayPal-Zahlungen: für eine Beratung zur Implementierung von PayPal stehen wir Ihnen gerne zur Verfügung.
Parameter für PayPal-Zahlungen
Ergebnis-Parameter für URLSuccess, URLFailure und URLNotify bei PayPal
Hinweis: Die Adress-Parameter werden immer an den Shop übergeben, sind aber leer, wenn keine Adressdaten ausgetauscht wurden.
Die PayPal-Methode "shortcut" ermöglicht einen geänderten Transaktionsablauf, bei dem der Kunde für die Zahlungsbestätigung in den Shop zurückgeleitet wird. Um im nächsten Schritt diese PayPal-Zahlung abzuschließen, nutzen Sie folgende URL und Parameter:
paypalComplete.aspx |
Parameter für PayPal-Zahlungen mit Methode "shortcut"
Ergebnis-Parameter bei PayPal mit Methode "shortcut"
Für eine PayPal Zahlung kann im Prozessablauf die ORDER von der anschließenden Autorisierung und nachfolgenden Schritten getrennt werden. Eine separate Autorisierung ist nur nach erfolgten Order (TxType=Order) möglich.
Für eine separate Autorisierung bei PayPal verwenden Sie bitte folgende URL:
Authorize.aspx |
Parameter für PayPal-Autorisierung
Ergebnis-Parameter bei PayPal-Autorisierung
Um eine Buchung (Capture) für PayPal über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:
capture.aspx |
Parameter für PayPal-Buchungen
Ergebnis-Parameter für PayPal-Buchungen
Um eine Gutschrift (Credit) mit Referenztransaktion für PayPal auszuführen, verwenden Sie bitte folgende URL:
credit.aspx |
Parameter für PayPal-Gutschriften mit Bezugstransaktion
Ergebnis-Parameter für PayPal-Gutschriften mit Bezugstransaktion
Um eine Gutschrift ohne Bezugstransaktion für PayPal abzuwickeln, verwenden Sie bitte folgende URL und Parameter:
paypalcreditEx.aspx |
Parameter für PayPal-Gutschriften ohne Bezugstransaktion
Ergebnis-Parameter für PayPal-Gutschriften ohne Bezugstransaktion
Um eine Transaktion bei PayPal zu stornieren, verwenden Sie bitte folgende URL und Parameter:
reverse.aspx |
Parameter für PayPal-Stornierungen
Ergebnis-Parameter für PayPal-Stornierungen
Die Abwicklung von PayPal-Zahlungen per Abonnement setzt eine Initial-Transaktion voraus, die über die übliche Schnittstelle abgewickelt worden ist. Zudem muss die Möglichkeit von Abonnements zuvor sowohl bei PayPal als auch bei aktiviert worden sein. Dazu muss die Option „Reference Transaction“ bei und bei PayPal eingerichtet sein. Zudem sind im Bereich „Verfügbare Genehmigungen“ bei der Einrichtung (siehe Kapitel PayPal-API freigeben oben) folgende 3 Optionen zu aktivieren:
- Belasten bestehender Kunden auf der Grundlage früherer Transaktionen
- Erstellen und Verwalten von Abonnementzahlungen
- Einholen der Autorisierung und Initiierung von PayPal-Zahlungen per Händlerabbuchung
Um eine PayPal-Zahlung per Abonnement abzuwickeln, nutzen Sie folgende URL und Parameter:
paypalAbo.aspx |
Parameter für PayPal-Abonnements
Ergebnis-Parameter für PayPal-Abonnements
Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer PayPal-Zahlung übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.
Bei den Batch-Aufrufen ist die verwendete Batch-Version zu unterscheiden, wovon die optionalen Parameter abhängen. Alle mit „2.“ beginnen Versionsbezeichnungen betreffen Aufrufe für einen Konzern. Das bedeutet, innerhalb einer Batch-Datei mit einer bestimmten MerchantID können auch Transaktionen anderer Händler mit einer abweichenden Sub-MID übertragen werden.
Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:
Beschreibung der möglichen Batch-Versionen
Der Aufbau für eine PayPal-Zahlung in einer einzureichenden Batch-Datei sieht folgendermaßen aus:
Beispiel für Master MID Funktion:
Hinweis: Bei Version 1.4 ist es auch möglich, bei einer Capture-Aktion den CompleteType zusätzlich mit zu übergeben:
PAYPAL,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>(,<CompleteType>,<TID>)
Beschreibung der Felder im Datensatz von Batch-Dateien
Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:
Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien