Über Ratepay

Allgemeines zu Ratepay

Mit Rechnungskauf reduzieren Sie als Händler die Bestellabbrüche in Ihrem Online-Shop um bis zu 81 Prozent. Dadurch erhöhen sich Ihre Konversionsrate und Ihr Umsatz. Deshalb ermöglicht das in mehreren europäischen Ländern den Rechnungskauf mit Zahlungsgarantie. Der Ratenkauf im Online-Shop motiviert Ihre Kunden, hochwertige Warenkörbe zu bestellen. So erhöht sich auch Ihr Umsatz. Das bietet deshalb Ratenkauf mit Zahlungsgarantie in mehreren europäischen Ländern an.

Bei Ratepay profitieren Sie als Händler von einem Fullservice für den Rechnungs- und Ratenkauf. Dafür übergeben Sie während der Bestellung nur alle Rechnungsdaten an den Dienstleister. Der übernimmt dann den gesamten Aufwand für Rechnungsstellung und Debitorenmanagement. Als Händler bekommen Sie eine Zahlungsgarantie. Außerdem bietet Ratepay klassische Ratenzahlung und SEPA-Lastschriftverfahren an.

Ratepay gewährt im Bestellprozess sekundenschnell eine Online-Zusage für den Ratenkauf. Ein PostIdent-Verfahren ist nicht nötig. Ratepay zahlt den Rechnungsbetrag kurzfristig an den Händler aus und trägt das Ausfallrisiko selbst.

Weitere Informationen finden Sie auch auf der Webseite von Ratepay (http://www.ratepay.com).

Diagramm zum Prozessablauf

Ratepay Prozessablauf

-Schnittstelle

Ratepay Rechnungs- und Ratenkauf

Ein Zahlungsvorgang mit Ratepay besteht aus mehreren Transaktionsschritten. Zu Anfang ist eine Initialisierung erforderlich, die als Ergebnis die zulässigen Zahlarten für den Kunden zurückliefert: Rechnungskauf, Ratenzahlung oder Lastschrift. Sofern der Kunde Ratenkauf wünscht, muss der Ratenrechner angezeigt werden. Anschließend wird die Zahlung angelegt, bestätigt, bei Bedarf geändert und schließlich gebucht. Gutschriften sind ebenfalls möglich.

Bei der Ratepay-Anbindung gibt es 5 verschiedene Requests, welche je nach Situation und Fortschritt im Bezahlprozess durchgeführt werden müssen. setzt diese Requests in die entsprechenden Ratepay-Requests um. Hierfür gilt folgendes Mapping:

Ratepay-Zahlungen initialisieren

Um eine Zahlung mit Ratepay über eine Server-zu-Server-Verbindung zu initialisieren, verwenden Sie bitte folgende URL:

Parameter für Ratepay-Zahlungen

Antwort-Parameter für Ratepay-Zahlungen

Ratepay-Ratenrechner

Für einen beabsichtigen Ratenkauf des Endkunden muss der Ratepay-Ratenrechner (vom Händler implementierte Oberfläche) angezeigt werden. Hier kann anhand des Betrages + z.B. der Dauer die Höhe der Raten (oder auch anhand der Raten die Laufzeit) ermittelt werden.

Um den Ratenrechner für Ratepay anzuzeigen, rufen Sie folgende URL auf:

Parameter für Ratepay-Ratenrechner

Antwort-Parameter für Ratepay-Ratenrechner

Die Konfiguration des Ratenrechners ist zwar von Ratepay fest vorgegeben, dennoch kann es zur Vermeidung von Folgefehlern hilfreich sein, diese Konfiguration vor der weiteren Verarbeitung abzufragen. Dazu rufen Sie folgende URL auf:

Parameter zur Abfrage der Konfiguration des Ratepay-Ratenrechners

Antwort-Parameter der Konfigurationsabfrage des Ratepay-Ratenrechners

Zahlungsvorgang anlegen

Um einen Zahlungsvorgang mit Ratepay anzulegen, verwenden Sie bitte folgende URL:

Parameter zum Anlegen einer Ratepay-Zahlung

Antwort-Parameter beim Anlegen einer Ratepay-Zahlung

Zahlungsvorgang bestätigen (Confirm)

Um einen Zahlungsvorgang mit Ratepay zu bestätigen, verwenden Sie bitte folgende URL:

Parameter zum Bestätigen einer Ratepay-Zahlung

Antwort-Parameter beim Bestätigen einer Ratepay-Zahlung

Ratepay-Zahlungsvorgang buchen (Komplett- / Teilbuchung)

Um einen Zahlungsvorgang mit Ratepay zu buchen, verwenden Sie bitte folgende URL:

Parameter zum Buchen einer Ratepay-Zahlung

Antwort-Parameter beim Buchen einer Ratepay-Zahlung

Storno / Rückgabe von Ratepay-Zahlungen

Um einen Zahlungsvorgang mit Ratepay teilweise oder vollständig zu stornieren oder Änderungen daran durchzuführen, verwenden Sie bitte folgende URL:

Hinweis: Für die verschiedenen Aktionen  (Eventtoken) gibt es Einschränkungen, wann welche Aktion durchgeführt werden darf. Nur vor der Buchung erlaubt sind: FC (Voll-Stornierung), PC (Teil-Stornierung), CO (Änderung). Nur nach der Buchung erlaubt sind FR (Voll-Rückgabe) und PR (Teil-Rückgabe).

Parameter für Storno / Änderung einer Ratepay-Zahlung

Antwort-Parameter bei Storno / Änderung einer Ratepay-Zahlung

Gutschrift von Ratepay-Zahlungen

Um eine Gutschrift mit Ratepay durchzuführen, verwenden Sie bitte folgende URL:

Parameter für Gutschrift einer Ratepay-Zahlung

Antwort-Parameter bei Gutschrift einer Ratepay-Zahlung

Erläuterung zum Parameter ShoppingBasket

Der Parameter ShoppingBasket erklärt die betreffenden Artikel der Transaktion und setzt sich aus mehreren Werten zusammen. Die einzelnen Parameter innerhalb eines Warenkorbs werden mit „;“ getrennt. Es sind nur die Werte einzutragen, nicht der zugehörige Parametername. Ungenutzte optionale Parameter sind als leeres Feld zu übergeben. Jeder weitere Artikel wird durch ein „+“ vom vorherigen abgegrenzt. Beispiel siehe unterhalb der Tabelle.

Folgende Tabelle beschreibt die einzelnen Werte innerhalb des ShoppingBasket:

Parameter innerhalb des Warenkorbes

Beispiel eines Warenkorbs mit 3 Artikeln:

ShoppingBasket=A;1;1;Bett;10000;1900;01233;1000;Blau+B;2;1;Handtuch;3000;1900;0234;;180x200+C;5;1;Kissen;1000;1900;;;

Batch-Nutzung der Schnittstelle

Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer Buchung oder Änderung bei Ratepay ü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 Buchung oder Gutschrift in einer einzureichenden Batch-Datei sieht folgendermaßen aus:

Beispiel für Master-MID-Funktion:

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