Vor dem Start

Dieser Quick Start Guide führt Sie Schritt für Schritt durch den Setup-Prozess der PAYONE Plattform. Anhand von Beispielen wird die Einrichtung und Konfiguration des Merchant-Accounts, die Nutzung der Schnittstellen und des PAYONE Merchant Interfaces (PMI) vorgestellt.

Die PAYONE Plattform ist modular aufgebaut, um für Ihr Geschäftsmodell das optimale und auf Ihre Bedürfnisse passende Leistungsspektrum zu bieten. Dieser Quick Start Guide führt exemplarisch durch eine Konfiguration – passen Sie sie nach Ihren Bedürfnissen an.

Weiterführende Dokumente helfen Ihnen dabei, zum Beispiel die technischen Referenzdokumente. Sollten Sie doch einmal nicht weiterkommen, hilft Ihnen der PAYONE Merchant Service gerne weiter.

Schritt für Schritt zur ersten Transaktion

Einrichtung Ihres Merchant-Accounts

Konfiguration eines Zahlungsportals

Jeder Zahlungsvorgang muss innerhalb der PAYONE Plattform einem Zahlungsportal zugewiesen werden. Während des Setup-Prozesses wurde durch das PAYONE Service Team bereits mindestens ein Zahlungsportal für Sie angelegt, welches nun von Ihnen konfiguriert werden muss. Hierzu findet man unter [Konfiguration] den Punkt [Zahlungsportale]. Wählt man diesen aus, erhält man eine Übersicht aller vorhandenen Zahlungsportale.

In Abhängigkeit des gewählten Portals müssen verschiedene Daten eingeben werden, exemplarisch wird hier die Konfiguration eines Portals des Typs Shop gezeigt (siehe Info-Box). Der vom PAYONE Team vergebene Portalname kann durch Sie geändert werden.

Um ein Zahlungsportal des Typs Shop zu erstellen, muss lediglich nach der Namensvergabe noch die Shop-URL im Format http://www.ihreURL.de angegeben werden. Abhängig von den gebuchten Optionen ist eine Absenderadresse für durch PAYONE zu versendende E-Mails an Endkunden einzutragen. Zusätzlich sind hier durch den PAYONE Merchant Service nach Buchung die verwendeten Schnittstellen aktiviert.

Bei einem Zahlungsportal des Types Zugang muss mindestens ein Angebot erstellt werden, welches evtl. noch nicht angelegt wurde.

Allgemein 

Sie haben zudem weitere folgende Konfigurationsmöglichkeiten für Nachrichten von der PAYONE Plattform an Ihr System:

Erweiterte Response-Daten

Hier können Sie für den Live- und Test-Modus getrennt einstellen, ob die API-Response zusätzliche Antwortparameter schickt.

• Ausschalten: es werden lediglich „status“, „txid“, und „userid“ in der Antwort geschickt.
• Einschalten: es werden zusätzlich Daten wie Mandats-Informationen und weitere Informationen zur Zahlungsart (abhängig von der Zahlungsart) geschickt.

Transaktions-Status

Hier können Sie den Inhalt des Transaktionsstatus definieren (für Live- und Test-Modus einheitlich).

Notify-Version

Version 7.6, empfohlene Einstellung für Neu-Integrationen: Neuer Parameter „transaction_status“ wurde eingeführt mit Werten „completed“ || „pending“ für "txaction=capture". Außerdem neuer Parameter „reasoncode“ für „transaction_status=pending“

Weitere Hinweise finden Sie in der Server-API-Dokumentation im Kapitel „Parameter for the TransactionStatus query“

Transaktions-Status Failed

• Melden: Es wird ein Transaktionsstatus für fehlgeschlagene Transaktionen verschickt (ab Notify-Version 7.5)
• Nicht melden: Es wird ein Transaktionsstatus für fehlgeschlagene Transaktionen unterdrückt.

Erweitert

Anschließend ist die Konfiguration im nächsten Reiter [Erweitert] fortzusetzen. Hier sollte die Trans­ak­tionsstatus-URL eingetragen werden, die Adresse, an die PAYONE Ihnen Statusänderungen aller Zahlungsvorgänge und weitere zahlungsrelevante Informationen per HTTP-Request übergeben soll.
Sie muss im Format http(s)://www.ihreURL.de angegeben werden. Außerdem wählen Sie hier den Key (siehe Info-Box).

Im PMI können eine Reihe genereller Vorgaben gemacht werden, die aber individuell mit Parametern des jeweiligen API-Requests überschrieben werden können. Generell gilt: Ein API-Request wird höher bewertet als Einstellungen im PMI. Details hierzu finden Sie in der API-Dokumentation. Überschreibbare erweiterte Einstellungen sind:

• Die Zurück-URL, auf die ein Käufer bei einer nicht erfolgreichen Transaktion weitergeleitet wird, zum Beispiel wenn er sich nach einer Weiterleitung (bspw. zu PayPal) für einen Kaufabbruch entscheidet
• Die Erfolgs-URL, auf die ein Käufer entsprechend bei erfolgreichem Abschluss der Bestellung weiter­ge­leitet wird.
• Der Verwendungszweck, der z.B. bei Lastschrift- oder Kreditkartenzahlungen dem Käufer auf seinem Konto­auszug bzw. seiner Kreditkartenabrechnung angezeigt wird. Priorisiert wird das, was im Shop hinterlegt ist. Ansonsten, wird das ausgegeben, was im Verwendungszweck hinterlegt ist bzw. falls nichts eingeben wurde, und nichts im Shop hinterlegt ist, wird die URL ausgegeben.

Das letzte Feld dient dem Hinzufügen von Templates für Benutzer der Frontend-Schnittstelle. Hier können Standardvorlagen für das Aussehen der Benutzeroberfläche eingefügt werden, die zusätzlich in einem er­weiterten Dialog individualisiert werden können. So fügen sich die Felder nahtlos in das Design Ihres Onlineangebots ein, PAYONE tritt infolgedessen in Ihrem Checkout-Prozess nicht in Erscheinung.

Optionen

Der Reiter [Optionen] wird bei der Anlegung Ihres Accounts bereits von uns vorbelegt und kann in teilen von Ihnen bearbeitet werden.

API-Parameter

Der Reiter [API-Parameter] enthält eine zusammenfassende Übersicht der absolut notwendigen Daten in der Kommunikation zu Ihrem Shop-System, sowie eine Auflistung der von Ihnen angelegten Sub-Accounts (nächster Abschnitt: Erstellung von Sub-Accounts).

Riskcheck

Erstellung von Sub-Accounts

Sub-Accounts dienen rein analytischen Zwecken und können nach Ihren eigenen Vorstellungen angelegt werden. Es können beliebig viele Sub-Accounts verwendet werden, mindestens einer muss aber erstellt werden.

Die wichtigsten Account-Daten auf einem Blick

Nutzen Sie die PAYONE Plattform über eine Extension, zum Beispiel für Magento, OXID oder pixi*? 
Dann müssen Sie in Ihrem Modul noch Daten wie die Portal-ID etc. eingeben. Diese und weitere notwendige Daten finden Sie unter:

API-Parameter

Auch bei der Anbindung der verschiedenen Schnittstellen benötigen Sie diese Daten.

Kommunikation mit der Plattform über Schnittstellen

Die Schnittstellen unterscheiden sich wesentlich in Ihren Funktionen, eine vollständige Beschreibung finden Sie in der Leistungsbeschreibung der PAYONE Plattform. Hier ein kurzer Überblick:

Section

Column Server API Client API  Frontend Stark vereinfachte PCI DSS-Zertifizierung für Händler Reservierung Kauf Einzug von Zahlungen Gutschrift buchen Forderung buchen Aktualisierung von Kundendaten Steuerung des Mahn­wesens Column PCI DSS: Sicherheit für Kreditkartendaten Der Payment Card Industry Data Security Standard (PCI DSS) ist ein Regelwerk zum Umgang mit Kreditkartendaten. Unternehmen, die Kreditkartendaten verarbeiten oder speichern, müssen sich zertifizieren lassen. Mit der Client API und Frontend jedoch können Sie als Händler die Zerti­fizierung stark vereinfachen, denn die sensiblen Daten werden direkt an die PAYONE Plattform weitergeleitet und verarbeitet. PAYONE selbst ist nach dem höchsten Level 1 PCI DSS zertifiziert. Weitere Informationen dazu erhalten Sie direkt auf unserer Website.

Ansprache der Plattform am Beispiel der Client/Server API

Jeder Zahlungsvorgang lässt sich als Aneinanderreihung einzelner Prozessschritte darstellen – in sogenannten Sequenzdiagrammen.

Anhand von zwei Beispielen werden nun häufige Geschäfts­vorfälle in einem Onlineangebot vom Kauf bis zur Auslieferung der Ware vorgestellt. Die Befehle und die Reihenfolge unterscheiden sich hier je nach genutzter Anbindung.

Details zu der von Ihnen genutzten Schnittstelle finden Sie in den technischen Referenzdokumenten (API-Dokus).

Sequenzdiagramm einer Kreditkartenzahlung mit Vorautorisierung

Beispielhaft erklären wir den Ablauf einer Kreditkartenzahlung mit Reservierung und Einzug.

Sequenzdiagramm einer Online-Überweisung

Transaktionslogs: Hilfe zur Fehleranalyse 

Ihre Transaktion wurde nicht erfolgreich beendet? Ein offener Transaktionsstatus kann auf eine Reihe von Gründen zurückzuführen sein. Einen ersten Anhaltspunkt finden Sie im PAYONE Merchant Interface (PMI). Suchen Sie unter Debitorenverwaltung die Transaktion anhand der PAYONE Vorgangsnummer (TX-ID) und klicken auf Details zum Zahlungsvorgang: Hier findet sich das Feld Fehlergrund. Sollte der Hinweis dort nicht zur Klärung ausreichen, können Sie unter [Konfiguration] >> [Transaktionsstatus] alle aktuell blockierten Trans­aktionen einsehen und weitere Details zum Fehlergrund aufrufen, sofern diese nicht älter als 48 Stunden sind und die maximale Versuchsanzahl von 12 noch nicht überschritten wurde.