Integration von giropay und Überweisung in die Express- Kaufabwicklung

Größe: px

Ab Seite anzeigen:

Download "Integration von giropay und Überweisung in die Express- Kaufabwicklung"

Karl Hafner
vor 6 Jahren
Abrufe

1 Integration von giropay und Überweisung in die Express- Kaufabwicklung Letzte Aktualisierung: August 2007

3 Inhalt Vorwort Dieses Handbuch Zielgruppe Bisherige Versionen Verwandte PayPal-Dokumentationen Kapitel 1 Integration von giropay und Banküberweisung in die Express- Kaufabwicklung7 Zahlungsfluss Fluss 'giropay-zahlung erfolgreich' Fluss 'Stornierte oder abgebrochene giropay-zahlung' giropay-integration Kaufabwicklung mit 'SetExpressCheckout' einleiten Kunden zu giropay weiterleiten Transaktion abschließen Benachrichtigung zum Transaktionsstatus August

4 Inhalt 4 August 2007

5 Vorwort Dieses Handbuch Dieses Handbuch beschreibt die Integration von giropay als Zahlungsart in die PayPal- Express-Kaufabwicklung. Ebenso wird die Integration der PayPal-Zahlung per Banküberweisung behandelt. HINWEIS: Dieses Dokument stellt eine Ergänzung zum Integrationshandbuch Express- Kaufabwicklung dar, das detaillierte Informationen zur Integration der PayPal-Express- Kaufabwicklung umfasst. Zielgruppe Dieses Handbuch richtet sich an Händler und Entwickler, und erläutert die Integration von giropay und Banküberweisung als Zahlungsarten in die bestehende Express-Kaufabwicklung. Bisherige Versionen Übersicht bisheriger Fassungen dieses Handbuchs. TABELLE P.1 Bisherige Versionen Datum August 2007 Beschreibung Erstfassung des Dokuments Verwandte PayPal-Dokumentationen Dieses Handbuch bezieht sich auf Informationen in folgenden Handbüchern und Referenzmaterialien: Integrationshandbuch Express-Kaufabwicklung PayPal Name-Value Pair API Developer Guide and Reference (auf Englisch) PayPal SOAP API Reference (auf Englisch) Integration von giropay und Überweisung in die Express-Kaufabwicklung August

6 Verwandte PayPal-Dokumentationen 6 August 2007 Integration von giropay und Überweisung in die Express-Kaufabwicklung

7 1 Integration von giropay und Banküberweisung in die Express- Kaufabwicklung Dieses Kapitel befasst sich mit dem Zahlungsfluss von giropay-transaktionen und Banküberweisungen sowie den erforderlichen Änderungen an der Integration. Zahlungsfluss auf Seite 7 illustriert die Zahlungsverarbeitung von giropay-transaktionen und manuellen Banküberweisungen. giropay-integration auf Seite 8 beschreibt erforderliche Änderungen an der API und Ihrer Programmierung zur Integration von giropay und Banküberweisung als Zahlungsquellen. Zahlungsfluss Wenn ein Kunde in der Express-Kaufabwicklung giropay als Zahlungsquelle wählt, leiten Sie ihn nach der 'Bestellung prüfen'-seite auf eine statische PayPal-URL, von wo aus er auf die giropay-website gelangt, um dort die Zahlung an den Händler abzuschließen. Nach Abschluss der giropay-zahlung wird die Transaktion bestätigt. Sollte die giropay-zahlung fehlschlagen oder vom Kunden abgebrochen werden, wird automatisch die PayPal-Zahlung per Banküberweisung als nächste Option eingesetzt (vorausgesetzt, Sie haben diese Option in Ihrem Profil nicht deaktiviert). Dabei stellt PayPal alle erforderlichen Informationen für die Banküberweisung zur Verfügung, welche der Kunde von seinem Bankkonto aus veranlassen muss. Fluss 'giropay-zahlung erfolgreich' Abbildung 1.1 zeigt den Fluss einer erfolgreichen giropay-zahlung Integration von giropay und Überweisung in die Express-Kaufabwicklung August

8 Integration von giropay und Banküberweisung in die Express-Kaufabwicklung giropay-integration ABBILDUNG 1.1Erfolgreich abgeschlossene giropay-zahlung Fluss 'Stornierte oder abgebrochene giropay-zahlung' Wenn eine giropay-zahlung aus irgendeinem Grund nicht abgeschlossen werden kann (z.b. aufgrund eines nicht gedeckten Bankkontos oder Abbruch durch den Kunden), stellt PayPal sämtliche Informationen für eine Zahlung per Banküberweisung bereit, die der Kunde von seinem Bankkonto aus veranlassen muss. Die Transaktion bleibt so lange "Offen", bis der entsprechende Betrag bei PayPal eingegangen ist und die Zahlung dem Empfänger gutgeschrieben wird. Erst dann ist die Zahlung abgeschlossen. Wenn Sie Zahlungen mit dem Status "Offen" in Ihrem PayPal-Profil deaktiviert haben, wird die Transaktion nicht ausgeführt. PayPal leitet den Kunden dann auf Ihre 'Bestellung abgebrochen'-seite weiter. giropay-integration In diesem Abschnitt finden Sie detaillierte Hinweise zu den erforderlichen Änderungen Ihrer Programmierung und der API zur Implementierung des Zahlungsfluss wie auf Seite 7 dargestellt. Kaufabwicklung mit 'SetExpressCheckout' einleiten Kunden zu giropay weiterleiten 8 August 2007 Integration von giropay und Überweisung in die Express-Kaufabwicklung

9 Integration von giropay und Banküberweisung in die Express-Kaufabwicklung giropay-integration Transaktion abschließen Benachrichtigung zum Transaktionsstatus Kaufabwicklung mit 'SetExpressCheckout' einleiten Zur Unterstützung von giropay-zahlungen benötigen Sie die folgenden drei URLs als Bestandteil der SetExpressCheckout-Aufrufs. Anhand dieser URLs leitet PayPal den Kunden auf die richtige Seite weiter, je nachdem ob eine Transaktion abgeschlossen wurde oder fehlgeschlagen ist. TABELLE 1.1 'SetExpressCheckout'-Felder für giropay und Banküberweisung NVP SOAP Beschreibung Erforderlich? GIROPAYSUCCESSURL giropaysuccessurl URL der Händler-Seite, auf die der Kunde nach erfolgreicher giropay- Zahlung geleitet wird. GIROPAYCANCELURL giropaycancelurl URL der Händler-Seite, auf die der Kunde nach fehlgeschlagener giropay- Zahlung oder Banküberweisung geleitet wird. BANKTXNPENDINGURL BanktxnPendingURL URL der Händler-Seite, auf die der Kunde nach einer Zahlung per Banküberweisung geleitet wird Nein Nein Nein Kunden zu giropay weiterleiten Nachdem der Kunde bei PayPal eine Zahlungsquelle ausgewählt hat, wird er auf Ihre Website zurückgeleitet - ebenso wie im regulären Fluss der Express-Kaufabwicklung. Es gibt ein zusätzliches Feld (REDIRECTREQUIRED), das als Teil der Antwort von GetExpressCheckoutDetails und DoExpressCheckoutPayment gesendet wird. Ist der Wert dieses Feldes positiv ('true'), wird der Kunde von Ihrer 'Bestellung prüfen'-seite auf umgeleitet. Von dieser Weiterleitungsseite aus gelangt der Kunde dann auf die entsprechende Seite der ausgewählten Zahlungsmethode. TABELLE 1.2 GetExpressCheckoutDetails und DoExpressCheckoutPayment response NVP SOAP Beschreibung REDIRECTREQUIRED RedirectRequired Weiterleitung des Kunden zu PayPal Mit dem Wert REDIRECTREQUIRED können Sie Ihren Kunden auf der Seite 'Bestellung prüfen' mitteilen, dass sie zum Abschließen der Transaktion auf die giropay-website weitergeleitet werden. Integration von giropay und Überweisung in die Express-Kaufabwicklung August

10 Integration von giropay und Banküberweisung in die Express-Kaufabwicklung giropay-integration Transaktion abschließen Entsprechend der drei Felder zu SetExpressCheckout (siehe Tabelle 1.1), nehmen Sie die folgenden drei zusätzlichen Seiten in Ihre Website auf: TABELLE 1.3 Zusätzlich erfoderliche Seiten für die giropay-integration Seite Bestellung abgeschlossen Bestellung abgebrochen Bestellung noch nicht abgeschlossen Beschreibung Seite, auf die der Kunde nach erfolgreicher giropay-zahlung weitergeleitet wird. Seite, auf die der Kunde nach fehlgeschlagener oder abgebrochener giropay- oder Banküberweisung weitergeleitet wird. Seite, auf die der Kunde nach eingeleiteter Zahlung per Banküberweisung weitergeleitet wird. Benachrichtigung zum Transaktionsstatus Nachdem der Kunden zu PayPal weitergeleitet wurde, werden Sie auf folgenden Wegen benachrichtigt: IPN (Sofortige zahlungsbestätigung) (nur bei erfolgreichen giropay-zahlungen und Banküberweisungen) PayPal-Kontoübersicht PayPal-Berichte 10 August 2007 Integration von giropay und Überweisung in die Express-Kaufabwicklung

Ähnliche Dokumente

IM.Superstore. Integration sofortüberweisung.de. Version 0.9

IM.Superstore. Integration sofortüberweisung.de. Version 0.9 IM.Superstore Integration sofortüberweisung.de Version 0.9 INHALT 1 Einleitung... 3 2 sofortüberweisung.de: Neues Projekt erstellen... 4 2.1 Allgemeine Einstellungen... 4 2.2 Adresse... 5 2.3 Spezielle