payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11...

44
payplace.express / PayPal Anbindung für Händler und Integratoren Titelseite

Transcript of payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11...

Page 1: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPalAnbindung für Händler und Integratoren

Titelseite

Page 2: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal

Anbindung für Händler und Integratoren

Revision: 1.0Ausgabedatum: 10.07.2012Erstfassung

Version 1.0

Ausgabedatum 10.07.2012

bezieht sich auf payplace.express Version 1.13

Page 3: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal

Inhaltsverzeichnis

1 Zu diesem Dokument

1.1 Kennzeichnungen und Visualisierung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.2 Haftungsausschluss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

1.3 Copyright-Hinweis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2 Einleitung

2.1 Zielgruppe, Aufgabe des Dokuments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.2 Voraussetzungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.3 Einführung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3 Shopschnittstelle

3.1 Transaktionsablauf Shopschnittstelle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.2 Transaktionsdetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.2.1 Initialisierung der Zahlung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.2.2 Autorisierung mit Buchung/Vorautorisierung . . . . . . . . . . . . . . . . . . . . . . 123.2.3 Buchung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133.2.4 Erstatten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143.2.5 Storno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143.2.6 Diagnose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

3.3 Parameterdetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

3.4 Formatbeschreibung der Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

4 Formularservice

4.1 Transaktionsablauf Formularservice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

4.2 Zugangsdaten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

4.3 Transaktionsdetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234.3.1 Initialisierung der Zahlung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244.3.2 Benachrichtigung des Shops. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

5 Anhang

Version 1.0 Ausgabedatum: 10.07.2012 3

Page 4: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal

5.1 Testdaten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

5.2 payplace.express Meldungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

5.3 Meldungen des VÖB-ZVD-Gateways . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Version 1.0 Ausgabedatum: 10.07.2012 4

Page 5: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 1.1 Kennzeichnungen und Visualisierung

1 Zu diesem Dokument

1.1 Kennzeichnungen und Visualisierung

Beachten Sie die folgenden Kennzeichnungen im Text:

Programmlistings, Quelltext

Hier stehen Auszüge aus dem Programmquelltext oder Listings. Beispiel:

Listing 1-1#!/bin/bash

# endless loopwhile [ true ]do

clear;free;sleep 1;

done

Parameter

Die Bezeichnungen sämtlicher Parameter erscheinen in folgender Schrift: para-meter.

Hinweis

Hinweis

Ein kontextbezogener Hinweis oder weiterführende Informationen.

Wichtig

Wichtig

Ein besonders wichtiger Hinweis.

Aufzählung

1. Ab hier folgen einzeln nummerierte Schritte.

2. Diese werden nacheinander ausgeführt.

Hervorhebungen

Aus inhaltlichen Gründen hervorzuhebende Wörter und wesentliche Informati-onen erscheinen kursiv gedruckt.

Version 1.0 Ausgabedatum: 10.07.2012 5

Page 6: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 1.2 Haftungsausschluss

1.2 Haftungsausschluss

Die Informationen in dieser Dokumentation sind mit größter Sorgfalt zusam-mengestellt worden. Die Dokumentation erhebt jedoch weder Anspruch auf Vollständigkeit noch Fehlerfreiheit. Es kann deshalb keine Haftung für die Ver-wendbarkeit und Richtigkeit übernommen werden. Für direkte, indirekte, zufäl-lige oder Folgeschäden, die aus der Anwendung der Informationen entstehen können, übernimmt die VÖB-ZVD - soweit gesetzlich zulässig - keine Haftung.

1.3 Copyright-Hinweis

Dieses Dokument ist urheberrechtlich geschützt. Kein Teil des Dokuments darf ohne vorherige schriftliche Genehmigung der VÖB-ZVD vervielfältigt oder unter Verwendung elektronischer Systeme verarbeitet oder verbreitet werden.

Alle Rechte vorbehalten © 2012.

Version 1.0 Ausgabedatum: 10.07.2012 6

Page 7: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 2.1 Zielgruppe, Aufgabe des Dokuments

2 Einleitung

2.1 Zielgruppe, Aufgabe des Dokuments

Dieses Dokument wendet sich an Online-Händler und Integratoren von payplace.express. Sie sollten über progammiertechnisches Basiswissen und grundlegende Kenntnisse zum elektronischen Zahlungsverkehr verfügen.

Dieses Dokument beschreibt die Integration von PayPal-Zahlungen mittels payplace.express. Wenn Sie Fragen zu PayPal haben, die sich nicht auf die Anbindung an payplace.express beziehen, wenden Sie sich bitte direkt an PayPal.

Das vorliegende Dokument ist als Erweiterung des Dokuments „payplace.express - Anbindung für Händler und Integratoren“ (im Folgenden als Hauptdokument bezeichnet) zu verstehen. Allgemeine Hinweise zur System-struktur, der Kommunikation zwischen Shop und payplace.express usw. finden Sie im Hauptdokument.

2.2 Voraussetzungen

Sie benötigen ein Geschäftskonto bei PayPal. Ferner ist es erforderlich, dass Sie payplace.express die Erlaubnis erteilen, in Ihrem Namen Zahlungen abzuwi-ckeln. Nutzen Sie hierzu das payplace.express Frontoffice. Unter Konfiguration - PayPal-Genehmigungen werden Sie auf Ihre PayPal-Profilseiten weitergeleitet. Dort erfahren Sie detailliert, welche Genehmigungen payplace.express benötigt und können diese mit einem Klick erteilen. Die von Ihnen erteilten Genehmi-gungen können Sie auf Ihren PayPal-Profilseiten verwalten.

2.3 Einführung

Sie können Zahlungen entweder über die Shopschnittstelle oder über den For-mularservice initialisieren. Die Details des jeweiligen Ablaufs sind in Abschnitt „Transaktionsablauf Shopschnittstelle“, S. 9 und Abschnitt „Transaktionsablauf Formularservice“, S. 22 beschrieben. Bei PayPal-Zahlungen entscheidet der Kunde erst im Verlauf des Zahlungsvorgangs, mit welchem Zahlungsmittel (Kre-ditkarte, Lastschrift, Überweisung oder giropay) er bezahlt. Bezahlt der Kunde mit giropay, ändert sich dadurch der Transaktionsablauf. Bei einer Zahlungsiniti-alisierung über die Shopschnittstelle erfordert dies unterschiedliche Aktionen Ihres Shops. Bei der Nutzung des Formularservice ist der Transaktionsablauf aus

Version 1.0 Ausgabedatum: 10.07.2012 7

Page 8: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 2.3 Einführung

Sicht Ihres Shops unabhängig von dem Zahlungsmittel, das der Kunde auf der PayPal-Webseite auswählt.

Die Folgetransaktionen Buchen, Erstatten und Storno können Sie nur über die Shopschnittstelle durchführen.

Version 1.0 Ausgabedatum: 10.07.2012 8

Page 9: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.1 Transaktionsablauf Shopschnittstelle

3 Shopschnittstelle

Allgemeine Informationen, Zugangsdaten sowie Beispielcode zur Shopschnitt-stelle finden Sie im Hauptdokument.

3.1 Transaktionsablauf Shopschnittstelle

Abbildung 3-1: Transaktionsablauf Shopschnittstelle

Version 1.0 Ausgabedatum: 10.07.2012 9

Page 10: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.1 Transaktionsablauf Shopschnittstelle

Die funktionalen Abläufe gestalten sich wie folgt:

1. Der Kunde kauft im Shop ein und leitet den Zahlungsvorgang ein.

2. Der Shop teilt payplace.express mit, dass ein Kunde mit PayPal bezahlen möchte. Dabei übermittelt der Shop payplace.express auch URLs, an welche der Kunde nach erfolgter Bezahlung bzw. im Fehlerfall weitergeleitet wer-den soll. Die Details dieser Anfrage sind in Abschnitt „Initialisierung der Zahlung“, S. 11 beschrieben.

3. Als Antwort sendet payplace.express dem Shop eine PayPal-URL zur Weiter-leitung des Kunden.

4. Der Shop sendet eine Weiterleitung zu dieser URL an den Browser des Kun-den. Die Weiterleitung kann durch einen entsprechenden Meta-Tag, einen HTTP-Header oder Javascript ausgelöst werden.

5. Der Browser des Kunden leitet zu PayPal weiter.

6. Der Kunde führt bei PayPal die zur Zahlung benötigten Schritte aus.

7. PayPal sendet dem Kunden eine Weiterleitung zu Ihrem Shop und zwar zu der URL, die Sie payplace.express in Schritt 2 übermittelt haben. Falls der Kunde in Schritt 6 die Zahlung abgebrochen hat, erfolgt die Weiterleitung an eine andere von Ihnen in Schritt 2 übermittelte URL.

8. Der Browser des Kunden leitet zum Shop weiter.

9. Der Shop sendet eine Autorisierungs- oder Vorautorisierungs-Anfrage an payplace.express. Falls Sie eine Information erhalten, dass der Kunde die Zahlung abgebrochen hat, ist der Vorgang beendet. Die Details dieser Anfrage sind in Abschnitt „Autorisierung mit Buchung/Vorautorisierung“, S. 12 beschrieben.

10. payplace.express informiert den Shop über den Ausgang der Zahlung. Falls es sich um eine giropay-Zahlung handelt, erhalten Sie einen speziellen Ant-wortcode und eine URL für die Weiterleitung an PayPal. In diesem Fall wird die Transaktion wie unten im giropay-Transaktionsablauf beschrieben fort-geführt.

11. Die Aktion des Shops hängt davon ab, welches Zahlungsmittel der Kunde wählt:

• Standard-Ablauf: der Shop zeigt dem Kunden das Ergebnis der Zahlung an. Der Vorgang ist hiermit beendet.

• giropay-Zahlung: der Shop sendet eine Weiterleitung an die in Schritt 10 empfangene PayPal-URL an den Kunden.

Die folgenden Schritte sind erforderlich, wenn der Kunde mit giropay bezahlt:

12. Der Browser des Kunden leitet an PayPal weiter.

13. PayPal antwortet dem Kunden mit einer Weiterleitung an giropay.

14. Der Browser des Kunden leitet an giropay weiter.

15. Der Kunde führt die giropay-Zahlung durch.

16. giropay sendet dem Kunden eine Weiterleitung an den Shop.

Version 1.0 Ausgabedatum: 10.07.2012 10

Page 11: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.2 Transaktionsdetails

17. Der Browser des Kunden leitet an den Shop weiter.

18. Der Shop sendet eine Transaktionsdiagnose (s. Abschnitt „Diagnose“, S. 15) an payplace.express.

19. payplace.express übermittelt die Zahlungsdetails an den Shop.

20. Der Shop zeigt dem Kunden das Ergebnis der Zahlung an.

Wenn der Kunde per Überweisung zahlt, bekommt er die Details für die Über-weisung angezeigt. Diese Seite enthält einen Link zu Ihrem Shop. Wenn der Kunde darauf klickt, erhalten Sie in Schritt 17 einen Request an die im Parame-ter paypal_banktxn_pending_url (s. unten) angegebene URL. Im Fall einer Über-weisung gilt die Zahlung bei PayPal erst als abgeschlossen, wenn die Überweisung bei PayPal eingegangen ist. PayPal benachrichtigt Sie dann per E-Mail. Sie können den aktuellen Stand der Überweisung auch jederzeit über eine Diagnose-Anfrage herausfinden (s. Abschnitt „Diagnose“, S. 15).

Bei den Folgetransaktionen Buchen, Erstatten und Storno gilt folgender einfa-che Transaktionsablauf: Ihr Shop sendet eine Anfrage an payplace.express. payplace.express sendet als Antwort das Ergebnis der Transaktion.

3.2 Transaktionsdetails

In den folgenden Tabellen finden Sie für jede Transaktion Angaben, welche Werte in der Anfragenachricht (Request) enthalten sein müssen und welche Werte Sie als Antwort (Response) erhalten.

Zur Steuerung der Transaktionsart werden die Parameter command und payment_options verwendet. Diese sind mit den in den Tabellen aufgeführten Werten zu besetzen.

Unter bestimmten Voraussetzungen ist es möglich, dass Parameter nicht in der Antwortnachricht enthalten sind. Diese Voraussetzungen werden in einer spal-tenübergreifenden Tabellenzeile genannt.

3.2.1 Initialisierung der Zahlung

Im Feld payment_options können Sie festlegen, ob Sie die Initialisierung für eine Autorisierung mit Buchung (payment_options=paypal oder payment_options=paypal;initauthorization) oder eine Vorautorisierung (payment_options=paypal;initpreauthorization) durchführen möchten. Optio-nal können Sie die Versandkosten (basket_shipping_costs) und alle Artikel, die der Kunde gekauft hat mit Name, Artikelnummer, Beschreibung, Preis und Anzahl angeben (Parameter basketitem_...). Diese Daten werden dem Kunden auf der PayPal-Bezahlseite angezeigt.

Version 1.0 Ausgabedatum: 10.07.2012 11

Page 12: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.2 Transaktionsdetails

Tabelle 3-1: Initialisierung der Zahlung

3.2.2 Autorisierung mit Buchung/Vorautorisierung

Der Wert des Felds command hängt von der vorangegangenen Initialisierung ab. Setzen Sie command=authorization, wenn Sie eine Initialisierung für eine Autori-sierung mit Buchung durchgeführt haben oder command=preauthorization, wenn Sie eine Initialisierung für eine Vorautorisierung durchgeführt haben. Das

Parameter Request Response

command Pflichtfeld, open

payment_options Pflichtfeld

orderid Pflichtfeld Pflichtfeld

basketnr Optional Optional

merchantref Optional

amount Pflichtfeld Pflichtfeld

currency Pflichtfeld Pflichtfeld

successurl Pflichtfeld

cancelurl Pflichtfeld

paypal_giropay_success_url Pflichtfeld

paypal_giropay_cancel_url Pflichtfeld

paypal_banktxn_pending_url Pflichtfeld

basket_shipping_costs Optional

basketitem_name0, basketitem_name1, ...

Optional

basketitem_number0, basketitem_number1, ...

Optional

basketitem_desc0, basketitem_desc1, ...

Optional

basketitem_qty0, basketitem_qty1, ...

Optional

basketitem_amount0, basketitem_amount1, ...

Optional

posherr Pflichtfeld

rmsg Pflichtfeld

rc Pflichtfeld, kann leer sein.

timestamp Pflichtfeld, kann leer sein.

trefnum Optional

redirecturl Pflichtfeld, wenn posherr=0

Version 1.0 Ausgabedatum: 10.07.2012 12

Page 13: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.2 Transaktionsdetails

Feld amount müssen Sie nur übergeben, wenn sich der Betrag vom Betrag der Initialisierung unterscheidet. trefnum ist die Transaktionsreferenznummer der Initialisierung und ist in der Antwort auf die Initialisierung enthalten.

Tabelle 3-2: Autorisierung mit Buchung/Vorautorisierung

3.2.3 Buchung

Diese Transaktion dient dem Einziehen eines Betrags, der in einer vorangegan-genen Vorautorisierung reserviert wurde. Ohne Angabe eines Betrags im Feld amount wird der gesamte Betrag der Vorautorisierung gebucht. Wenn Sie nur einen Teilbetrag buchen möchten, geben Sie im Feld amount den gewünschten Betrag ein. Sie können mehrere Teilbuchungen durchführen, bis der gesamte Betrag der Vorautorisierung gebucht wurde. trefnum ist die Transaktionsrefe-renznummer der Vorautorisierung und ist in der Antwort auf die Vorautorisie-rung enthalten.

Parameter Request Response

command Pflichtfeld, authorization, preauthorization

merchantref Optional

payment_options Pflichtfeld, paypal

orderid Pflichtfeld Pflichtfeld

trefnum Pflichtfeld Pflichtfeld

basketnr Optional Optional

amount Optional Optional

currency Optional

posherr Pflichtfeld

rmsg Pflichtfeld

rc Pflichtfeld, kann leer sein.

timestamp Pflichtfeld, kann leer sein.

retrefnr Optional, wenn posherr=0

redirecturl Pflichtfeld, wenn posherr=363 und der Kunde mit giropay bezahlt.

Parameter Request Response

command Pflichtfeld, capture

payment_options Pflichtfeld, paypal

orderid Pflichtfeld Pflichtfeld

trefnum Pflichtfeld Pflichtfeld

basketnr Optional Optional

Version 1.0 Ausgabedatum: 10.07.2012 13

Page 14: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.2 Transaktionsdetails

Tabelle 3-3: Buchung

3.2.4 Erstatten

Diese Transaktion dient dem Erstatten eines Betrags, der in einer vorangegan-genen Autorisierung mit Buchung oder Buchung gebucht wurde. Ohne Angabe eines Betrags im Feld amount wird der gesamte Betrag der Vorgängertransaktion erstattet. Wenn Sie nur einen Teilbetrag erstatten möchten, geben Sie im Feld amount den gewünschten Betrag ein. Sie können mehrere Teilerstattungen durchführen, bis der gesamte gebuchte Betrag erstattet wurde.

Tabelle 3-4: Erstatten

3.2.5 Storno

Diese Transaktion dient dazu, eine vorangegangene Vorautorisierung zu stor-nieren.

amount Optional Optional

currency Optional

posherr Pflichtfeld

rmsg Pflichtfeld

rc Pflichtfeld, kann leer sein.

timestamp Pflichtfeld, kann leer sein.

retrefnr Optional, wenn posherr=0

Parameter Request Response

Parameter Request Response

command Pflichtfeld, refund

payment_options Pflichtfeld, paypal

orderid Pflichtfeld Pflichtfeld

trefnum Pflichtfeld Pflichtfeld

basketnr Optional Optional

amount Optional Optional

currency Optional

posherr Pflichtfeld

rmsg Pflichtfeld

rc Pflichtfeld, kann leer sein.

timestamp Pflichtfeld, kann leer sein.

retrefnr Optional, wenn posherr=0

Version 1.0 Ausgabedatum: 10.07.2012 14

Page 15: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.2 Transaktionsdetails

Tabelle 3-5: Storno

3.2.6 Diagnose

Mit dieser Transaktion können Sie sich die Zahlungsdetails einer bereits durch-geführten Transaktion erneut zusenden lassen. Wenn ein Kunde mit giropay oder per Überweisung bezahlt, können Sie sich mit einer Diagnose über den Ausgang der Zahlung informieren. Der Wert posherr=0 signalisiert, dass die Transaktion erfolgreich durchgeführt wurde. posherr=363 bedeutet, dass die Zahlung noch nicht abgeschlossen ist, z.B. wenn der Kunde per Überweisung bezahlt und die Überweisung noch nicht bei PayPal angekommenn ist. Andere Werte von posherr bedeuten einen Fehler. Die Bedeutung der unterschiedli-chen Werte der Antwortcodes posherr und rc ist im Anhang in Tabelle 5-1, S. 40 und Tabelle 5-2, S. 44 erklärt.

Parameter Request Response

command Pflichtfeld, reversal

payment_options Pflichtfeld, paypal

orderid Pflichtfeld Pflichtfeld

trefnum Pflichtfeld Pflichtfeld

basketnr Optional Optional

amount Optional

currency Optional

posherr Pflichtfeld

rmsg Pflichtfeld

rc Pflichtfeld, kann leer sein.

timestamp Pflichtfeld, kann leer sein.

Parameter Request Response

command Pflichtfeld, diagnostic

payment_options Pflichtfeld, paypal

orderid Pflichtfeld Pflichtfeld

trefnum Pflichtfeld Pflichtfeld, in Response enthalten, wenn Parameter rc einen Wert enthält.

basketnr Optional

amount Optional

currency Optional

posherr Pflichtfeld

rmsg Pflichtfeld

rc Pflichtfeld, kann leer sein.

Version 1.0 Ausgabedatum: 10.07.2012 15

Page 16: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.3 Parameterdetails

Tabelle 3-6: Diagnose

3.3 Parameterdetails

amount

Tabelle 3-7: Parameter amount

basket_shipping_costs

Tabelle 3-8: Parameter basket_shipping_costs

basketitem_amount0, basketitem_amount1, ...

Tabelle 3-9: Parameter basketitem_amount0, basketitem_amount1, ...

basketitem_desc0, basketitem_desc1, ...

Tabelle 3-10: Parameter basketitem_desc0, basketitem_desc1, ...

timestamp Pflichtfeld, kann leer sein.

retrefnr Optional

Parameter Request Response

Wertebereich N-12

Beispiel 12000

Erläuterung Der Betrag in der kleinsten Einheit einer Währung. Der Wert 5025 entspricht bei der Währung Euro also 50 Euro und 25 Cent. Ausnahme: in der Antwort auf eine Folgetransaktion (Buchung, Erstattung, Storno), bei der in der Anfrage kein Be-trag mitgegeben wurde, wird der Betrag mit Dezimalkomma zurückgegeben, also z.B. 50,25.

Wertebereich N-12

Beispiel 690

Erläuterung Versandkosten in der kleinsten Einheit einer Währung. Wird dem Kunden von PayPal beim Bezahlen angezeigt.

Wertebereich N-12

Beispiel 1250

Erläuterung Preis eines Artikels. Wird dem Kunden von PayPal beim Bezahlen angezeigt.

Wertebereich ANL-50

Beispiel 500 GB externe Festplatte

Erläuterung Beschreibung eines Artikels. Wird dem Kunden von PayPal beim Bezahlen ange-zeigt.

Version 1.0 Ausgabedatum: 10.07.2012 16

Page 17: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.3 Parameterdetails

basketitem_name0, basketitem_name1, ...

Tabelle 3-11: Parameter basketitem_name0, basketitem_name1, ...

basketitem_number0, basketitem_number1, ...

Tabelle 3-12: Parameter basketitem_number0, basketitem_number1, ...

basketitem_qty0, basketitem_qty1, ...

Tabelle 3-13: Parameter basketitem_qty0, basketitem_qty1, ...

basketnr

Tabelle 3-14: Parameter basketnr

cancelurl

Tabelle 3-15: Parameter cancelurl

Wertebereich ANL-32

Beispiel Gabel

Erläuterung Name eines Artikels. Wird dem Kunden von PayPal beim Bezahlen angezeigt.

Wertebereich ANL-32

Beispiel E1234CA

Erläuterung Artikelnummer. Wird dem Kunden von PayPal beim Bezahlen angezeigt.

Wertebereich N-9

Beispiel 1

Erläuterung Anzahl eines Artikels. Wird dem Kunden von PayPal beim Bezahlen angezeigt.

Wertebereich ANLS-50

Beispiel 874-09, Blumen-Shop

Erläuterung Die Warenkorbnummer. Vom Händler frei belegbares Feld zur Übermittlung von Zusatzinformationen..

Wertebereich ANS-255

Beispiel http://shop.mycompany.com/cancelled

Erläuterung URL für den Rücksprung zum Shop nach Abbruch durch den Benutzer

Version 1.0 Ausgabedatum: 10.07.2012 17

Page 18: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.3 Parameterdetails

command

Tabelle 3-16: Parameter command

currency

Tabelle 3-17: Parameter currency

merchantref

Tabelle 3-18: Parameter merchantref

orderid

Tabelle 3-19: Parameter orderid

payment_options

Tabelle 3-20: Parameter payment_options

Wertebereich FIX

Beispiel open

Erläuterung Beschreibt zusammen mit dem Parameter payment_options die Transaktionsart.

Wertebereich A3

Beispiel EUR

Erläuterung Der Währungscode gemäß ISO 4217.

Wertebereich AN-30

Beispiel RH_6712

Erläuterung Mitteilung an den Verkäufer. Wird der Parameter bei einer Zahlungsinitialisie-rung übermittelt, zeigt PayPal den Wert dem Kunden bei der Zahlungsbestäti-gung an. Der Wert kann in diesem Fall vom Kunden auch geändert werden.

Wertebereich AN[-_/]-17

Beispiel ans_834732

Erläuterung Eindeutige Vorgangsnummer, die diese Transaktion für einen Shop identifiziert.

Wertebereich FIX

Beispiel paypal;initpreauthorization

Erläuterung Beschreibt zusammen mit dem Parameter command die Transaktionsart.

Version 1.0 Ausgabedatum: 10.07.2012 18

Page 19: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.3 Parameterdetails

paypal_banktxn_pending_url

Tabelle 3-21: Parameter paypal_banktxn_pending_url

paypal_giropay_cancel_url

Tabelle 3-22: Parameter paypal_giropay_cancel_url

paypal_giropay_success_url

Tabelle 3-23: Parameter paypal_giropay_success_url

posherr

Tabelle 3-24: Parameter posherr

rc

Tabelle 3-25: Parameter rc

Wertebereich ANS-255

Beispiel http://shop.mycompany.com/banktxn_pending

Erläuterung URL für den Rücksprung zum Shop, wenn der Kunde mit einer Überweisung be-zahlt

Wertebereich ANS-255

Beispiel http://shop.mycompany.com/giropay_cancel

Erläuterung URL für den Rücksprung zum Shop nach abgebrochener giropay-Zahlung

Wertebereich ANS-255

Beispiel http://shop.mycompany.com/giropay_success

Erläuterung URL für den Rücksprung zum Shop nach erfolgreicher giropay-Zahlung

Wertebereich N-3

Beispiel 102

Erläuterung Primärer Rückgabecode des Systems (payplace.express Meldungen).

Wertebereich N-4

Beispiel 000

Erläuterung Sekundärer Rückgabecode des Systems. Die konkreten Inhalte sind im Anhang erläutert.

Version 1.0 Ausgabedatum: 10.07.2012 19

Page 20: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.3 Parameterdetails

redirecturl

Tabelle 3-26: Parameter redirecturl

retrefnr

Tabelle 3-27: Parameter retrefnr

rmsg

Tabelle 3-28: Parameter rmsg

successurl

Tabelle 3-29: Parameter successurl

timestamp

Tabelle 3-30: Parameter timestamp

Wertebereich ANS-255

Beispiel https://www.paypal.com/cgi-bin/webscr?cmd=_express-checkout&userac-tion=commit&token=EC-1NG55023YC981762E

Erläuterung URL zur Weiterleitung des Kunden

Wertebereich ANLS-32

Beispiel 234231235

Erläuterung Transaktionsnummer des Backend-Systems.

Wertebereich ANLS-200

Beispiel

Erläuterung Ergebnis als Text.

Wertebereich ANS-255

Beispiel http://shop.mycompany.com/success

Erläuterung URL für den Rücksprung zum Shop nach erfolgreicher Transaktion

Wertebereich N14

Beispiel 20030510134159

Erläuterung Zeitstempel der Transaktion im Format JJJJMMDDHHMMSS (CET).

Version 1.0 Ausgabedatum: 10.07.2012 20

Page 21: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 3.4 Formatbeschreibung der Parameter

trefnum

Tabelle 3-31: Parameter trefnum

3.4 Formatbeschreibung der Parameter

In der folgenden Tabelle sind alle Zeichen aufgeführt und erklärt, die das For-mat eines Parameters definieren.

Tabelle 3-32: Formatbeschreibung

Wertebereich ANS-50

Beispiel ans_834732_01

Erläuterung payplace.express Transaktionsreferenznummer. Diese Nummer wird bei Trans-aktionen, die eine Nachbearbeitung vorheriger Transaktionen darstellen (zum Beispiel Stornieren), als Referenz verwendet.

Zeichen Bedeutung

A Buchstaben

N Ziffern

S Sonderzeichen

L Leerzeichen

Xn genau n Zeichen

X-n maximal n Zeichen

FIX feste Zeichenkette

[] Eine Anzahl erlaubter Zeichen wird zwischen eckigen Klammern aufgelistet. a

a Ist auch die eckige Klammer erlaubt, wird diese doppelt aufgeführt z.B. [[].

Beispiele

N5 Ziffer mit genau 5 Zeichen

ANS-10 Zeichenkette mit bis zu 10 Zeichen. Diese Zeichenkette kann Buchstaben, Ziffern und Sonderzeichen enthalten, aber keine Leerzeichen

AN[_]-10 Zeichenkette mit bis zu 10 Zeichen. Diese Zeichenkette kann Buchstaben, Ziffern und das Zeichen '_' enthalten, aber keine Leerzeichen

Version 1.0 Ausgabedatum: 10.07.2012 21

Page 22: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 4.1 Transaktionsablauf Formularservice

4 Formularservice

4.1 Transaktionsablauf Formularservice

Abbildung 4-1: Transaktionsablauf Formularservice

Version 1.0 Ausgabedatum: 10.07.2012 22

Page 23: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 4.2 Zugangsdaten

1. Der Kunde kauft im Shop ein und leitet den Zahlungsvorgang ein.

2. Der Shop antwortet mit einer Weiterleitung zu payplace.express. Die Wei-terleitung kann durch einen entsprechenden Meta-Tag, einen HTTP-Header oder Javascript ausgelöst werden. In der Weiterleitungs-URL sind die zur Verarbeitung notwendigen Daten enthalten.

3. Der Browser des Kunden leitet zu payplace.express weiter.

4. Als Antwort sendet payplace.express dem Kunden eine Weiterleitung zu PayPal.

5. Der Browser des Kunden leitet zu PayPal weiter.

6. Der Kunde führt bei PayPal die zur Zahlung benötigten Schritte aus.

7. PayPal sendet dem Kunden eine Weiterleitung zu payplace.express.

8. Der Browser des Kunden leitet zu payplace.express weiter.

9. payplace.express informiert den Shop über den Ausgang der Zahlung.

10. Der Shop bestätigt den Empfang der Zahlungsbenachrichtigung und über-mittelt payplace.express eine URL zur Weiterleitung des Kunden

11. payplace.express sendet dem Kunden eine Weiterleitung zu der in Schritt 10 übermittelten URL.

12. Der Browser des Kunden leitet zu dieser URL weiter.

13. Der Shop zeigt dem Kunden das Ergebnis der Zahlung an.

Transaktionsablauf mit giropay

Bezahlt der Kunde mit giropay, so werden zwischen Schritt 7 und 8 weitere Schritte notwendig, an denen der Shop jedoch nicht beteiligt ist. D.h. für den Transaktionsablauf aus Sicht des Shops spielt es beim Formularservice keine Rolle, mit welchem Zahlungsmittel der Kunde bezahlt.

4.2 Zugangsdaten

Richten Sie Ihre Anfragen an folgende URL:

Testzugang:

https://testsystem.payplace.de/formservice/de/formservice/prot/SSLPayment.po

Produktivzugang:

https://system.payplace.de/formservice/de/formservice/prot/SSLPayment.po

4.3 Transaktionsdetails

In den folgenden Abschnitten finden Sie Details zur Initialisierung einer PayPal-Zahlung und zur Benachrichtigung des Shops durch payplace.express.

Version 1.0 Ausgabedatum: 10.07.2012 23

Page 24: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 4.3 Transaktionsdetails

4.3.1 Initialisierung der Zahlung

Die in der folgenden Tabelle aufgeführten Parameter werden über den Browser des Kunden durch eine Weiterleitung an payplace.express übermittelt (Schritte 2 und 3 in Abschnitt „Transaktionsablauf Formularservice“, S. 22). Die Weiterlei-tung kann durch einen HTTP-Redirect-Header, eine HTML-Seite mit einem ent-sprechenden Meta-Tag oder per Javascript-Formular erfolgen. Ein Beispiel für die Weiterleitung mittels Meta-Tag finden Sie im Hauptdokument.

Erläuterungen zu den Angaben in der Spalte Wertebereich finden Sie im Abschnitt „Formatbeschreibung der Parameter“, S. 21.

Parameterübersicht Anfragenachricht

amount

Tabelle 4-1: Parameter amount

basket_shipping_costs

Tabelle 4-2: Parameter basket_shipping_costs

basketid

Tabelle 4-3: Parameter basketid

basketitem_amount0, basketitem_amount1, ...

Tabelle 4-4: Parameter basketitem_amount0, basketitem_amount1, ...

Wertebereich N[,]-10

Beispiel 22,60

Erläuterung Pflichtfeld, Betrag mit Dezimalkomma

Wertebereich N[,]-10

Beispiel 6,90

Erläuterung Versandkosten. Wird dem Kunden von PayPal beim Bezahlen angezeigt.

Wertebereich ANLS-50

Beispiel ba_100202

Erläuterung Optional, Kennung des bestellten Warenkorbs oder Artikels.

Wertebereich N[,]-10

Beispiel 12,50

Erläuterung Preis eines Artikels. Wird dem Kunden von PayPal beim Bezahlen angezeigt.

Version 1.0 Ausgabedatum: 10.07.2012 24

Page 25: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 4.3 Transaktionsdetails

basketitem_desc0, basketitem_desc1, ...

Tabelle 4-5: Parameter basketitem_desc0, basketitem_desc1, ...

basketitem_name0, basketitem_name1, ...

Tabelle 4-6: Parameter basketitem_name0, basketitem_name1, ...

basketitem_number0, basketitem_number1, ...

Tabelle 4-7: Parameter basketitem_number0, basketitem_number1, ...

basketitem_qty0, basketitem_qty1, ...

Tabelle 4-8: Parameter basketitem_qty0, basketitem_qty1, ...

command

Tabelle 4-9: Parameter command

Wertebereich ANL-50

Beispiel 500 GB externe Festplatte

Erläuterung Beschreibung eines Artikels. Wird dem Kunden von PayPal beim Bezahlen ange-zeigt.

Wertebereich ANL-32

Beispiel Gabel

Erläuterung Name eines Artikels. Wird dem Kunden von PayPal beim Bezahlen angezeigt.

Wertebereich ANL-32

Beispiel E1234CA

Erläuterung Artikelnummer. Wird dem Kunden von PayPal beim Bezahlen angezeigt.

Wertebereich N-9

Beispiel 1

Erläuterung Anzahl eines Artikels. Wird dem Kunden von PayPal beim Bezahlen angezeigt.

Wertebereich FIX

Beispiel sslform

Erläuterung Pflichtfeld, Requestdefinition

Version 1.0 Ausgabedatum: 10.07.2012 25

Page 26: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 4.3 Transaktionsdetails

currency

Tabelle 4-10: Parameter currency

mac

Tabelle 4-11: Parameter mac

notifyurl

Tabelle 4-12: Parameter notifyurl

notificationfailedurl

Tabelle 4-13: Parameter notificationfailedurl

orderid

Tabelle 4-14: Parameter orderid

Wertebereich A3

Beispiel EUR

Erläuterung Pflichtfeld, Währungscode gemäß ISO 4217.

Wertebereich N[abcdef]40

Beispiel 0fab98c2d51992adff4732e2c5ab8599f15723e3

Erläuterung Pflichtfeld, Message Authentication Code, dient der Absicherung gegen Manipula-tionen der Zahlungsdaten.

Wertebereich ANS-255

Beispiel http://shop.mycompany.com/notify

Erläuterung Optional, URL für die Shopbenachrichtigung. Falls nicht angegeben, wird die im Frontoffice konfigurierte URL verwendet, siehe unten.

Wertebereich ANS-255

Beispiel http://shop.mycompany.com/notification_failed

Erläuterung Optional, URL an die der Kunde nach der Zahlung weitergeleitet wird, wenn die Shopbenachrichtigung fehlschlägt. Falls nicht angegeben, zeigt payplace.express in diesem Fall eine Standard-Fehlerseite an.

Wertebereich AN[-_/]-17

Beispiel order_10123487

Erläuterung Pflichtfeld; Vorgangsnummer

Version 1.0 Ausgabedatum: 10.07.2012 26

Page 27: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 4.3 Transaktionsdetails

paymentmethod

Tabelle 4-15: Parameter paymentmethod

payment_options

Tabelle 4-16: Parameter payment_options

sessionid

Tabelle 4-17: Parameter sessionid

sslmerchant

Tabelle 4-18: Parameter sslmerchant

MAC - Message Authentication Code

Näheres zur Berechnung des MAC finden Sie im Anhang des Hauptdokuments.

Abweichend von der Beschreibung im Hauptdokument erfolgt die Berechnung des MAC über die Werte aller übergebenen Parameter, alphabetisch sortiert nach den Parameternamen (entspricht der Reihenfolge in obiger Tabelle).

Reaktion des payplace.express-Servers

Als Reaktion auf diesen per Weiterleitung übermittelten Request antwortet payplace.express dem Kunden mit einer Weiterleitung des Kunden zu PayPal.

Wertebereich FIX

Beispiel paypal

Erläuterung Pflichtfeld, Zahlungsart

Wertebereich FIX

Beispiel preauthorization

Erläuterung Optional, Transkationstyp. Mögliche Werte sind preauthorization und authoriza-tion. Falls nichts angegeben wurde, wird authorization angenommen.

Wertebereich ANS-50

Beispiel S9805976-AB

Erläuterung Optional, Kennung der aktuellen Session im Onlineshop, wird für die Shopbenach-richtigung verwendet

Wertebereich ANS-16

Beispiel mycompany

Erläuterung Pflichtfeld, Händlerkennung

Version 1.0 Ausgabedatum: 10.07.2012 27

Page 28: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 4.3 Transaktionsdetails

4.3.2 Benachrichtigung des Shops

Nach Abwicklung der Zahlung informiert payplace.express den Shop über das Ergebnis (Schritt 9 in Abschnitt „Transaktionsablauf Formularservice“, S. 22). payplace.express ruft dazu die im Parameter notifyurl angegebene URL auf bzw., falls dieser Parameter nicht übergeben wurde, die im Frontoffice vom Shopbetreiber eingestellte URL für die Shopbenachrichtigung.payplace.express überträgt in diesem Request die in den folgenden Tabellen enthaltenen Para-meter. Die Benachrichtigung des Shops erfolgt auch bei Auftreten eines Fehlers, Timeouts oder nach Abbruch der Zahlung durch den Kunden.

Hinweis

Wenn Sie die SSL-verschlüsselte Übertragung der Shopbenachrichtigung wünschen, benötigen Sie ein SSL-Zertifikat, das von einer anerkannten Zertifizierungsstelle auf den Server ausgestellt wurde, den Sie in der URL für die Shopbenachrichtigung angeben. Selbst generierte Zertifikate wer-den nicht akzeptiert. Sie erhalten in diesem Fall keine Shopbenachrichti-gung. Sie erhalten ebenfalls keine Shopbenachrichtigung, wenn der Servername in der URL für die Shopbenachrichtigung nicht mit dem Ser-ver übereinstimmt, für den das Zertifikat ausgestellt wurde. Das gilt z.B. auch, wenn Sie in der URL für die Shopbenachrichtigung die IP-Adresse statt des Servernamens angeben.

Wichtig

Wenn Ihre Shopbanchrichtigung SSL-verschlüsselt übertragen wird, tes-ten Sie bitte nach einem Wechsel des SSL-Zertifikats, ob die Shopbenach-richtigung nach wie vor funktioniert.

amount

Tabelle 4-19: Parameter amount

basketid

Tabelle 4-20: Parameter basketid

Wertebereich N[,]-10

Beispiel 22,60

Erläuterung Betrag mit Dezimalkomma

Wertebereich ANLS-50

Beispiel ba_100202

Erläuterung Kennung des bestellten Warenkorbs oder Artikels.

Version 1.0 Ausgabedatum: 10.07.2012 28

Page 29: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 4.3 Transaktionsdetails

currency

Tabelle 4-21: Parameter currency

directPosErrorCode

Tabelle 4-22: Parameter directPosErrorCode

directPosErrorMessage

Tabelle 4-23: Parameter directPosErrorMessage

mac

Tabelle 4-24: Parameter mac

orderid

Tabelle 4-25: Parameter orderid

Wertebereich A3

Beispiel EUR

Erläuterung Währungscode gemäß ISO 4217.

Wertebereich N-3

Beispiel 0

Erläuterung Primärer Rückgabecode des Systems, Details siehe Tabelle 5-1, S. 40

Wertebereich ANSL-255

Beispiel Genehmigung verweigert.

Erläuterung ggf. Fehlermeldung

Wertebereich N[abcdef]40

Beispiel 0fab98c2d51992adff4732e2c5ab8599f15723e3

Erläuterung Message Authentication Code, dient der Absicherung gegen Manipulationen der Zahlungsdaten.

Wertebereich AN[-_/]-17

Beispiel order_10123487

Erläuterung Vorgangsnummer

Version 1.0 Ausgabedatum: 10.07.2012 29

Page 30: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 4.3 Transaktionsdetails

rc

Tabelle 4-26: Parameter rc

sessionid

Tabelle 4-27: Parameter sessionid

retrefnum

Tabelle 4-28: Parameter retrefnum

trefnum

Tabelle 4-29: Parameter trefnum

Message Authentication Code - MAC

Die Shopbenachrichtigung enthält im Parameter mac den Message Authentica-tion Code (MAC), der es Ihnen ermöglicht, eine Manipulation der Shopbenach-richtigung zu erkennen. Dazu muss Ihre Anwendung aus den Parametern der Shopbenachrichtigung den MAC berechnen. Stimmt der so berechnete MAC mit dem in der Shopbenachrichtigung übertragenen MAC überein, können Sie davon ausgehen, dass die Shopbenachrichtigung unverfälscht ist.

Näheres zur Berechnung des MAC finden Sie im Anhang des Hauptdokuments

Abweichend von der Beschreibung im Hauptdokument erfolgt die Berechnung des MAC über die Werte aller oben ganannten Parameter (außer mac), alphabe-tisch sortiert nach den Parameternamen (entspricht der Reihenfolge in obiger Tabelle).

Wertebereich N-4

Beispiel 000

Erläuterung Sekundärer Rückgabecode des Payment-Systems.

Wertebereich ANS-50

Beispiel S9805976-AB

Erläuterung Kennung der aktuellen Session im Onlineshop, wie in der Anfragenachricht ange-geben

Wertebereich ANLS-50

Beispiel 6F781621CJ033261R

Erläuterung PayPal Transaktionsnummer

Wertebereich ANS-50

Beispiel order_10123487_01

Erläuterung payplace.express Transaktionsnummer

Version 1.0 Ausgabedatum: 10.07.2012 30

Page 31: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 4.3 Transaktionsdetails

URL für Shopbenachrichtigung

Die URL für die Shopbenachrichtigung können Sie in der Anfragenachricht im Parameter notifyurl angeben. Falls dieser Parameter nicht übergeben wird, wird die im Frontoffice eingetragene URL verwendet. Die URL können Sie unter Konfiguration - Formularservice konfigurieren. Geben Sie die URL im Eingabe-feld URL für Shopbenachrichtigung ein. Den Schlüssel für die MAC-Berechnung können Sie ebenfalls in diesem Formular konfigurieren. (Ein bereits konfigurier-ter MAC-Schlüssel wird aus Sicherheitsgründen nicht angezeigt.) Das Feld CSS-URL ist für PayPal-Zahlungen nicht relevant. Klicken Sie auf Speichern, wenn Sie alle benötigten Felder ausgefüllt haben.

Abbildung 4-2: URL für Shopbenachrichtigung konfigurieren

Parameterübersicht Shopbenachrichtigung

Auf diese Nachricht erwartet payplace.express eine Bestätigung von Ihrem Shop (Schritt 10 in Abschnitt „Transaktionsablauf Formularservice“, S. 22).

Die Antwort auf eine Benachrichtigung ist ein URL-kodiertes Dokument, das lediglich den Parameter rurls enthält. Der Wert dieses Parameters ist die URL des Shops, an die payplace.express den Kunden anschließend weiterleitet (Schritte 11 und 12 in Abschnitt „Transaktionsablauf Formularservice“, S. 22).

Die Antwort auf eine Benachrichtigung sollte innerhalb von 30 Sekunden erfol-gen.

Version 1.0 Ausgabedatum: 10.07.2012 31

Page 32: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 4.3 Transaktionsdetails

Tabelle 4-30: Parameterübersicht Shopbenachrichtigung - Antwort

Beispiel

Eine Antwortnachricht könnte wie folgt gestaltet sein:

Listing 4-1rurls=http://www.myshop.com/cgi-bin/shopres?sid=2347286yqwq6

Parameter Wertebereich Beispiel Erläuterungen

rurls ANS-255 http://www.mys-hop.com/cgi-bin/auth_formdata

URL zur Weiterleitung des Kun-den

Version 1.0 Ausgabedatum: 10.07.2012 32

Page 33: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.1 Testdaten

5 Anhang

5.1 Testdaten

Zahlungen im Testsystem werden nur simuliert. Das Testsystem kommuniziert mit der PayPal Sandbox. Die Sandbox ist das Testsystem von PayPal. Um es zu nutzen benötigen Sie spezielle Nutzerkonten - produktive Nutzerkonten können in der Sandbox nicht verwendet werden. Für Tests benötigen Sie ein Geschätfs- und mindestens ein Kundenkonto in der PayPal Sandbox.

5.2 payplace.express Meldungen

In der folgenden Tabelle finden Sie Erläuterungen für die Rückgabewerte des Feldes . In der ersten Spalte finden Sie den Rückgabewert. Die zweite Spalte enthält die Bedeutung dieses Wertes. Die dritte Spalte gibt Hinweise, wie das Händlersystem auf diesen Rückgabewert reagieren sollte.

Beachten Sie bei der Weiterverarbeitung dieser Meldungen im Shopsystem, dass diese nicht für die unmittelbare Weitergabe an den bestellenden Kunden gedacht sind. Ggf. sollten vereinfachte Meldungen wie Genehmigt, Genehmi-gung abgelehnt oder Zur Zeit keine Verarbeitung möglich an den Kunden gelei-tet werden. Für die Ausstellung eines ordnungsgemäßen Beleges nutzen Sie bitte die Belegfunktion von payplace.express.

Falsch kann auch bedeuten, dass der entsprechende Wert leer oder nicht vor-handen ist.

Version 1.0 Ausgabedatum: 10.07.2012 33

Page 34: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.2 payplace.express Meldungen

Ergebnis-wert

Bedeutung Reaktion

0 Transaktion erfolgreich abge-schlossen

Eintrag des Ergebnisses in die Datenbank bzw. das Shopsystem.

100 Transaktion mit dem Payment-Gateway ohne Erfolg abge-schlossen.

Für die weitere Verarbeitung der Anfrage ist die Analyse des vom Gateway erhaltenen Errorcodes (Feld rc) ausschlaggebend.

102 Zeitüberschreitung Der Shop darf keine weitere Transaktion mit dieser Vorgangsnummer durchführen, um Doppelbu-chungen zu vermeiden. Der zugrundeliegende Ge-schäftsprozess sollte die Zahlung als nicht durch-geführt betrachten. Der Zustand dieser Transaktion am Gateway ist unbekannt. Der Händ-ler sollte in diesem Falle den Support-Mitarbeiter um Klärung bitten. Ist die Transaktion auf dem Gateway erfolgreich abgeschlossen worden, wird die Zahlung vom Support-Mitarbeiter storniert.

103 Transaktion mit eScore ohne Er-folg abgeschlossen.

Für die weitere Verarbeitung der Anfrage ist die Analyse des vom Gateway erhaltenen Errorcodes (Feld rc) ausschlaggebend.

104 POA-Transaktion ohne Erfolg ab-geschlossen.

Für die weitere Verarbeitung der Anfrage ist die Analyse des vom Gateway erhaltenen Errorcodes (Feld rc) ausschlaggebend.

106 Keine Transaktion unter dieser trefnum.

Es ist zu untersuchen, ob die angegebene Transak-tionsreferenznummer wirklich einer Vorgänger-transaktion entspricht. Ist dies der Fall, sollte der Support zur Klärung kontaktiert werden.

107 Keine Transaktion unter dieser Vorgangsnummer.

Es ist zu untersuchen, ob die angegebene Vor-gangsnummer wirklich einer Vorgängertransak-tion entspricht. Ist dies der Fall, sollte der Support zur Klärung kontaktiert werden.

108 Vorgangsnummer schon verge-ben.

Wählen Sie für jede Transaktion eine eindeutige Vorgangsnummer.

118 Ungültiger Betrag für Rückerstat-tung oder Buchung

Überprüfen Sie den übergebenen Betrag und ver-gleichen Sie ihn mit dem Betrag der Vorgänger-transaktion.

133 Karte abgelaufen Der Shop sollte wenn möglich den Kunden zur Korrektur der eingegebenen Kreditkartendaten auffordern und die Transaktion erneut einreichen.

141 Kartentyp ist vom Händler nicht akzeptiert.

Weisen Sie den Kunden auf die möglichen Kredit-kartentypen hin. Sollte der Fehler nicht durch die Kundeneingaben hervorgerufen werden, melden Sie sich bitte bei Ihrem Support-Mitarbeiter zur Klärung.

Version 1.0 Ausgabedatum: 10.07.2012 34

Page 35: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.2 payplace.express Meldungen

151 Ungültige Antwortnachricht Führen Sie keine weitere Transaktion mit dieser Vorgangsnummer durch, um Doppelbuchungen zu vermeiden. Der zugrundeliegende Geschäfts-prozess sollte die Zahlung als nicht durchgeführt betrachten. Der Zustand dieser Transaktion am Gateway ist unbekannt. Bitten Sie Kunden-Support um Klärung. Ist die Transaktion auf dem Gateway erfolgreich abgeschlossen worden, wird die Zah-lung vom Support-Mitarbeiter storniert.

156 Parameter orderid falsch. Überprüfen Sie den Inhalt des Parameters orderid und vergleichen Sie dessen Format mit der Doku-mentation.

157 Parameter creditc falsch. Überprüfen Sie den Inhalt des Parameters creditc und vergleichen Sie dessen Format mit der Doku-mentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

158 Parameter expdat falsch. Überprüfen Sie den Inhalt des Parameters expdat und vergleichen Sie dessen Format mit der Doku-mentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an. Bieten Sie dem Kunden Auswahlfelder an, um Fehleingaben zu vermeiden.

159 Parameter currency falsch. Überprüfen Sie den Inhalt des Parameters cur-rency und vergleichen Sie dessen Format mit der Dokumentation. Für Lastschriften muss die Wäh-rung EUR lauten. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an. Bieten Sie dem Kunden eine Aus-wahl der möglichen Währungen an, um Fehlein-gaben zu vermeiden.

160 Parameter amount falsch. Überprüfen Sie den Inhalt des Parameters amount und vergleichen Sie dessen Format mit der Doku-mentation.

162 Parameter trefnum falsch. Überprüfen Sie den Inhalt des Parameters trefnum und vergleichen Sie dessen Format mit der Doku-mentation.

165 Unzulässiger Parameter Überprüfen Sie die in der Anfragenachricht über-gebenen Parameter und vergleichen Sie diese mit den in der Dokumentation beschriebenen Pflicht-parametern.

166 Parameter command falsch. Überprüfen Sie den Inhalt des Parameters command und vergleichen Sie dessen Format mit der Doku-mentation.

172 Zugriff verweigert. Melden Sie sich bitte bei Ihrem Support-Mitarbei-ter zur Klärung, wenn diese Antwort mehrmals auftritt.

Ergebnis-wert

Bedeutung Reaktion

Version 1.0 Ausgabedatum: 10.07.2012 35

Page 36: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.2 payplace.express Meldungen

186 Zugrundeliegende Transaktion bereits gebucht, storniert oder abgeschlossen.

Prüfen Sie, ob Sie versehentlich versucht haben, die Transaktion zweimal durchzuführen.

197 Ungültige Anfrage Implementieren Sie die Schnittstelle entsprechend der Dokumentation. Sollten Sie das Problem nicht beheben können, wenden Sie sich an Ihren Sup-port-Mitarbeiter.

198 System vorübergehend außer Betrieb.

Melden Sie sich bitte bei Ihrem Support-Mitarbei-ter zur Klärung, wenn diese Antwort mehrmals auftritt.

199 System-Fehler Der Zustand dieser Transaktion am Gateway ist un-bekannt. Bitten Sie den Support-Mitarbeiter um Klärung.

300 Keine Verbindung zum Gateway Melden Sie sich bitte bei Ihrem Support-Mitarbei-ter zur Klärung, wenn diese Antwort mehrmals auftritt.

303 Parameter cvcode falsch. Überprüfen Sie den Inhalt des Parameters cvcode und vergleichen Sie dessen Format mit der Doku-mentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

304 Parameter bankcode falsch. Überprüfen Sie den Inhalt des Parameters bank-code und vergleichen Sie dessen Format mit der Dokumentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

305 Parameter account falsch. Überprüfen Sie den Inhalt des Parameters account und vergleichen Sie dessen Format mit der Doku-mentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

307 Nutzung von Lastschrift nicht er-laubt.

Melden Sie sich bitte bei Ihrem Support-Mitarbei-ter zur Klärung, wenn diese Antwort mehrmals auftritt.

308 Konfiguration für diese Zahlung oder Vorprüfung wurde nicht an-gelegt.

Melden Sie sich bitte bei Ihrem Support-Mitarbei-ter zur Klärung, wenn diese Antwort mehrmals auftritt.

309 Konfiguration für diese Zahlung oder Vorprüfung wurde ge-sperrt.

Melden Sie sich bitte bei Ihrem Support-Mitarbei-ter zur Klärung, wenn diese Antwort mehrmals auftritt.

310 Parameter payment_options falsch.

Überprüfen Sie den Inhalt des Parameters payment_options und vergleichen Sie dessen For-mat mit der Dokumentation.

311 Parameter customer_id falsch. Überprüfen Sie den Inhalt des Parameters customer_id und vergleichen Sie dessen Format mit der Dokumentation.

Ergebnis-wert

Bedeutung Reaktion

Version 1.0 Ausgabedatum: 10.07.2012 36

Page 37: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.2 payplace.express Meldungen

312 Parameter customer_title falsch.

Überprüfen Sie den Inhalt des Parameters customer_title und vergleichen Sie dessen For-mat mit der Dokumentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

313 Parameter customer_firstname falsch.

Überprüfen Sie den Inhalt des Parameters customer_firstname und vergleichen Sie dessen Format mit der Dokumentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

314 Parameter customer_lastname falsch.

Überprüfen Sie den Inhalt des Parameters customer_lastname und vergleichen Sie dessen Format mit der Dokumentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

315 Parameter customer_date_of_birth falsch.

Überprüfen Sie den Inhalt des Parameters customer_date_of_birth und vergleichen Sie des-sen Format mit der Dokumentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

316 Parameter customer_addr_street falsch.

Überprüfen Sie den Inhalt des Parameters customer_addr_street und vergleichen Sie dessen Format mit der Dokumentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

317 Parameter customer_addr_number falsch.

Überprüfen Sie den Inhalt des Parameters customer_addr_number und vergleichen Sie dessen Format mit der Dokumentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

318 Parameter customer_addr_zip falsch.

Überprüfen Sie den Inhalt des Parameters customer_addr_zip und vergleichen Sie dessen Format mit der Dokumentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

319 Parameter customer_addr_city falsch.

Überprüfen Sie den Inhalt des Parameters customer_addr_city und vergleichen Sie dessen Format mit der Dokumentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

320 Parameter customer_addr_country falsch.

Überprüfen Sie den Inhalt des Parameters customer_addr_country und vergleichen Sie des-sen Format mit der Dokumentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

321 Parameter customer_since_mm falsch.

Überprüfen Sie den Inhalt des Parameters customer_since_mm und vergleichen Sie dessen Format mit der Dokumentation.

Ergebnis-wert

Bedeutung Reaktion

Version 1.0 Ausgabedatum: 10.07.2012 37

Page 38: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.2 payplace.express Meldungen

322 Parameter customer_since_yy falsch.

Überprüfen Sie den Inhalt des Parameters customer_since_yy und vergleichen Sie dessen Format mit der Dokumentation.

323 Diese Transaktionsart ist für den konfigurierten Gateway nicht er-laubt.

Überprüfen Sie den Inhalt der Parameter command und payment_options und vergleichen Sie deren Format mit der Dokumentation.

324 Fehler im Request bei der Ein-gangsprüfung

Melden Sie sich bitte bei Ihrem Support-Mitarbei-ter zur Klärung, wenn diese Antwort mehrmals auftritt.

332 Parameter providerid falsch. Überprüfen Sie den Inhalt des Parameters provi-derid und vergleichen Sie dessen Format mit der Dokumentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

333 Parameter msisdn falsch. Überprüfen Sie den Inhalt des Parameters msisdn und vergleichen Sie dessen Format mit der Doku-mentation. Weisen Sie ggf. Ihren Kunden auf die Fehleingabe hin und bieten Sie eine Korrektur des Wertes an.

334 Parameter paymentmethod falsch. Überprüfen Sie den Inhalt des Parameters pa-ymentmethod und vergleichen Sie dessen Format mit der Dokumentation.

335 Parameter tracenumber falsch. Überprüfen Sie den Inhalt des Parameters tracen-umber und vergleichen Sie dessen Format mit der Dokumentation.

336 Parameter terminalid falsch. Überprüfen Sie den Inhalt des Parameters termi-nalid und vergleichen Sie dessen Format mit der Dokumentation.

337 Parameter terminalid und tra-cenumber müssen gemeinsam übermittelt werden.

Überprüfen Sie den Inhalt der Parameter termina-lid und tracenumber. Die Übermittlung nur eines der beiden Parameter ist unzulässig.

338 3-D-Secure Autorisierung fehlge-schlagen.

Weisen Sie Ihren Kunden auf die eventuelle Fehl-eingabe hin. Die Transaktion kann wiederholt wer-den.

339 Parameter autocapture falsch. Überprüfen Sie den Inhalt des Parameters auto-capture und vergleichen Sie dessen Format mit der Dokumentation.

341 Der Mobilfunkbetreiber wird vom Händler nicht akzeptiert.

Überprüfen Sie den Inhalt des Parameters provi-derid und vergleichen Sie dessen Format mit der Dokumentation.

342 Parameter basketnr falsch. Überprüfen Sie den Inhalt des Parameters bas-ketnr und vergleichen Sie dessen Format mit der Dokumentation.

343 Kreditkarte nicht in einem der akzeptierten Länder ausgege-ben.

Bitten Sie den Kunden, ein anderes Zahlungsmittel zu verwenden.

Ergebnis-wert

Bedeutung Reaktion

Version 1.0 Ausgabedatum: 10.07.2012 38

Page 39: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.2 payplace.express Meldungen

344 Kreditkarte nicht im angegebe-nen Land ausgegeben.

Bitten Sie den Kunden, ein anderes Zahlungsmittel zu verwenden.

345 Dieser Händler darf nur Beträge bereits durchgeführter Transakti-onen erstatten.

Prüfen Sie, ob die Erstattung einer Transaktion zu-zuordnen ist.

346 Parameter timestamp falsch. Überprüfen Sie den Inhalt des Parameters time-stamp und vergleichen Sie dessen Format mit der Dokumentation.

347 Abbruch durch Benutzer. Lassen Sie den Kunden ein anderes Bezahlverfah-ren auswählen.

349 Das Transaktionslimit für dieses Zahlungsmittel wurde über-schritten.

Zeigen Sie dem Kunden eine Fehlermeldung an. Überprüfen Sie ggf. im Frontoffice Ihre Limit-Konfi-guration.

350 Dieses Zahlungsmittel ist auf der Sperrliste.

Zeigen Sie dem Kunden eine Fehlermeldung an. Überprüfen Sie ggf. im Frontoffice Ihre Sperrliste.

351 Mit diesem Institut sind giropay-Zahlungen derzeit nicht möglich.

Zeigen Sie dem Kunden eine Fehlermeldung an.

352 Die Bankleitzahl ist unbekannt. Zeigen Sie dem Kunden eine Fehlermeldung an. Bieten Sie dem Kunden an, es noch einmal zu ver-suchen. Möglicherweise handelt es sich um einen Tippfehler.

353 Die angegebene Pseudokarten-nummer existiert bereits.

Senden Sie die Anfrage noch einmal mit einer neuen, noch nicht vergebenen Pseudokartennum-mer oder geben Sie keine Pseudokartennummer an. Sie erhalten dann in der Antwort eine eindeu-tige, von payplace.express generierte Pseudokar-tennummer.

354 Die Nutzung von Pseudokarten-nummern ist für den Händler nicht freigeschaltet.

Wenn Sie die Nutzung von Pseudokartennum-mern vereinbart haben, liegt vermutlich eine Fehl-konfiguration vor. Wenden Sie sich in diesem Fall bitte an den Kunden-Support. Ansonsten prüfen Sie bitte die Eingabeparameter.

355 Dieser Händler darf nur Transak-tionen mit Pseudokartennum-mer durchführen.

Wenn Sie die Nutzung von Pseudokartennum-mern nicht vereinbart haben, liegt vermutlich eine Fehlkonfiguration vor. Wenden Sie sich in diesem Fall bitte an den Kunden-Support. Ansonsten prü-fen Sie bitte die Eingabeparameter.

356 Die angegebene Pseudokarten-nummer ist unbekannt.

Überprüfen Sie den Wert der Pseudokartennum-mer. Eventuell ist ein vorangegangener Versuch, diese Pseudokartennummer anzulegen fehlge-schlagen und Sie nehmen deshalb irrtümlicher-weise an, dass diese Pseudokartennummer bereits existiert.

357 Parameter ppan falsch. Überprüfen Sie den Inhalt des Parameters ppan und vergleichen Sie dessen Format mit der Doku-mentation.

Ergebnis-wert

Bedeutung Reaktion

Version 1.0 Ausgabedatum: 10.07.2012 39

Page 40: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.3 Meldungen des VÖB-ZVD-Gateways

Tabelle 5-1: payplace.express Meldungen

5.3 Meldungen des VÖB-ZVD-Gateways

Im Feld rc sind folgende Werte möglich:

358 Für die angegebene Kartennum-mer existiert bereits eine Pseu-dokartennummer.

Falls Sie nicht mehr wissen, welche Pseudokarten-nummer zu dieser Kreditkarte gehört, bietet Ihnen die Shop-Schnittstelle eine Möglichkeit, die Pseu-dokartennummer herauszufinden. Lesen sie dazu die Dokumentation.

359 Eine Transaktion mit dieser Vor-gangsnummer wird derzeit bear-beitet.

Sie haben eine Transaktion vermutlich zeitgleich zweimal eingereicht. Bitte vermeiden Sie dies zu-künftig.

360 Der Händler darf an dieser Schnittstelle keine Kreditkarten-daten einreichen.

Benutzen Sie Pseudokartennummern an dieser Schnittstelle. Falls Sie PCI zertifiziert sind, können Sie Ihren Zugang so konfigurieren lassen, dass Sie an dieser Schnittstelle Kreditkarten einreichen dürfen.

361 Parameter additionalnote falsch.

Überprüfen Sie den Inhalt des Parameters additi-onalnote und vergleichen Sie dessen Format mit der Dokumentation.

362 Institut nimmt nicht an giropay teil.

Bieten Sie dem Kunden an, eine andere Bankver-bindung anzugeben oder eine andere Zahlungs-weise auszuwählen.

363 Zahlung noch nicht abgeschlos-sen.

Bei einer Autorisierung: leiten Sie den Kunden zu der im Parameter redirecturl angegebenen URL weiter.

364 Limit überschritten

365 Zu hohes Ausfallrisiko

366 PayPal-Token ungültig

367 Nachbearbeitung bei PayPal durch den Händler notwendig.

Führen Sie bei PayPal die notwendige Nachbear-beitung durch.

368 Kunde muss Zahlungsmethode bei PayPal ändern

Bitten Sie den Kunden, bei PayPal eine andere Zah-lungsmethode zu wählen.

Ergebnis-wert

Bedeutung Reaktion

Ergebnis-wert

Bedeutung

000 Genehmigt oder erfolgreich beendet

002 Genehmigungsservice anrufen

003 Ungültige Händlerkennung

004 Karte einziehen

Version 1.0 Ausgabedatum: 10.07.2012 40

Page 41: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.3 Meldungen des VÖB-ZVD-Gateways

005 Genehmigung verweigert

012 Ungültige Transaktion

013 Kreditlimit überschritten

014 Ungültige Karte

021 Keine Verarbeitung

030 Formatfehler Autorisierer

031 Routing nicht definiert

033 Verfalldatum ungültig

034 Manipulationsverdacht

040 Funktion/Kartentyp nicht unterstützt

043 Gestohlene Karte, bitte einziehen

055 Falsche PIN

056 Karte nicht in der Datenbank des Autorisierers

057 Karte nicht identisch mit der Karte der zugrundeliegenden Transaktion

058 Terminalkennung unbekannt

061 Karte gesperrt

062 Eingeschränkt nutzbare Karte

064 Betrag höher als bei der zugrundeliegenden Transaktion

074 PIN muss erneuert werden

075 Zu viele PIN-Fehleingaben

077 PIN-Eingabe obligatorisch

080 Umsatz nicht mehr verfügbar

081 Fehler im Nachrichtenfluss

085 Ablehnung durch den Autorisierer

086 Der Händler ist unbekannt

091 Autorisierer z.Zt. nicht erreichbar

092 Dieser Kartentyp wird durch den Autorisierer nicht bearbeitet

096 Verarbeitung z.Zt. nicht möglich

098 Zeitstempel nicht plausibel oder Sequenzierungsproblem

101 AID-File für die Umgelenkte/capture Anfrage wurde nicht gefunden (evtl. Reservie-rung abgelaufen).

102 AID-File für die Umgelenkte/Gesicherte Anfrage konnte nicht gelesen werden.

103 AID-File für die Umgelenkte/Gesicherte Anfrage konnte nicht geschrieben werden.

200 Kann Beleg-Nummer für das virtuelle POS nicht lesen.

Ergebnis-wert

Bedeutung

Version 1.0 Ausgabedatum: 10.07.2012 41

Page 42: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.3 Meldungen des VÖB-ZVD-Gateways

201 Kann Trace-Nummer für das virtuelle POS nicht lesen.

203 Kein freies Terminal für diesen Händler

207 Autorisierung unterbrochen wegen Time-out.

209 Keine Verbindung zum Autorisierungssystem

210 Fehler bei der Verbindung zum Routingsystem.

212 Die Trace-Nummer in der Antwort unterscheidet sich von der aus der Anfrage.

213 Die Terminal-ID in der Antwort unterscheidet sich von der ursprünglichen.

214 Ankommende Nachricht kann nicht in das ZVT-Protokoll überführt werden.

215 Abgehende Nachricht kann nicht in das ZVT-Protokoll überführt werden.

216 Die Message-Number aus der Antwort stimmt nicht mit der angeforderten Funktion überein.

217 Diese Message-Number wird nicht vom IPS unterstützt.

218 Ungültiger Betrag für Storno oder Buchung

231 Ungültiger Währungscode

705 POS-Terminal Table wurde nicht vorher erstellt.

706 Unmögliches Anhängen an eine Semaphore für die POS-Administration.

707 Unmögliches Freimachen einer Semaphore für die POS-Administration.

719 Das angezeigte POS-Terminal für diesen Händler konnte nicht gefunden werden.

841 Authentifizierung SET ist nicht freigeschaltet.

842 Authentifizierung 3D-Secure ist nicht freigeschaltet

843 Authentifizierung UCAF ist nicht freigeschaltet

844 Transaktionsart EMV ist nicht freigeschaltet

845 Transaktionsart eCommerce ist nicht freigeschaltet

846 Transaktionsart POS ist nicht freigeschaltet

847 Transaktionsart MailOrder ist nicht freigeschaltet

850 Das PGW-Interface konnte nicht die komplette Antwort vom Autorisierungssystem zu-rücksenden .

851 Die Antwort vom virtuellen POS-Terminal enthält keine oder ungültige Daten.

852 Terminal antwortet nicht

860 Die vom PGW-Interface empfangene Datenlänge stimmt nicht mit der erwarteten Länge überein.

861 Das PGW-Interface konnte nicht den benötigten Speicher für die ankommenden Daten bereitstellen.

862 Terminal antwortet nicht

863 Das Feld msgnr enthält eine ungültige Größe.

Ergebnis-wert

Bedeutung

Version 1.0 Ausgabedatum: 10.07.2012 42

Page 43: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.3 Meldungen des VÖB-ZVD-Gateways

864 Das Feld msgnr fehlt in der ankommenden Nachricht.

865 Das Feld nrofgoods fehlt in der ankommenden Nachricht.

866 Eine oder mehrere der vorgeschriebenen Felder fehlen in der ankommenden Nach-richt.

867 Das PGW-Interface konnte nicht genügend Speicher für die ankommende Nachricht zur Verfügung stellen.

868 Die Händler-Daten-Datei konnte nicht gefunden oder gelesen werden.

869 Die Händler-System-Daten-Datei konnte nicht gefunden oder gelesen werden.

870 Der Händler ist dem IP-System unbekannt.

871 Die Händler-System-ID konnte nicht gelesen werden oder die Anweisung der Händler-System-ID passt nicht zum Händler.

872 Der Händler ist nicht berechtigt zur Nutzung des PGW-Interfaces.

873 Das Händlerpasswort ist nicht korrekt.

874 Das Händlersystempasswort ist nicht korrekt.

875 Die Transaktion konnte nicht gefunden werden im IP-System (dies ist eine Antwort auf eine Diagnoseanfrage).

876 Die ankommende Nachricht konnte nicht zum virtuellen POS-Terminal gesendet wer-den um die Autorisierung auszuführen.

877 Der Gültigkeitscheck für die Kartennummer ist fehlgeschlagen.

878 Länge der Kartennummer falsch

879 Die Byte-Größe zum Lesen ist nicht definiert.

880 Die angegebene Byte-Größe zum Lesen ist null.

881 Ein oder mehrere vorgeschriebene Felder in der ankommenden Nachricht enthalten keinen Wert.

882 Routingsystem vorübergehend außer Betrieb

883 Kontonummer ist für diese Bankleitzahl ungültig

884 Bankleitzahl ist ungültig

885 Formatfehler in den Eingangsdaten

890 Unbekannter Fehler. Melden Sie sich bitte bei Ihrem Support-Mitarbeiter zur Klärung.

891 Authentifizierung SET ist für diesen Händler nicht freigeschaltet

892 Authentifizierung 3DSecure ist für diesen Händler nicht freigeschaltet

893 Authentifizierung Spa-Ucaf ist für diesen Händler nicht freigeschaltet

894 EMV-Transaktionen sind für diesen Händler nicht freigeschaltet.

895 Die Transaktionsart eCommerce ist für diesen Händler nicht freigeschaltet.

896 Die Transaktionsart POS ist für diesen Händler nicht freigeschaltet

Ergebnis-wert

Bedeutung

Version 1.0 Ausgabedatum: 10.07.2012 43

Page 44: payplace.express Anbindung PayPal 1.0.fm - BS PAYONE · Version 1.0 Ausgabedatum: 10.07.2012 11 payplace.express / PayPal 3.2 Transaktionsdetails 17. Der Browser des Kunden leitet

payplace.express / PayPal 5.3 Meldungen des VÖB-ZVD-Gateways

Tabelle 5-2: Meldungen des VÖB-ZVD-Payment-Gateways und der Kartenprozessoren

897 Die Transaktionsart MailOrder ist für diesen Händler nicht freigeschaltet

898 Die Transaktionsart Abonnement ist für diesen Händler nicht freigeschaltet

899 Vorgangsnummer schon vergeben im Backend-System

Ergebnis-wert

Bedeutung

Version 1.0 Ausgabedatum: 10.07.2012 44